From a5184cab7f11480d2528b0d0ea7e1186629f7f31 Mon Sep 17 00:00:00 2001 From: Kweku Adams Date: Thu, 12 Nov 2020 10:20:19 -0800 Subject: [PATCH] Update JobParameters documentation. Explicitly call out a situation in which the app could specify a network constraint but get a null value in JobParameters.getNetwork(). Also add link to JobInfo.Builder.setRequiredNetwork(). Bug: 19536175 Test: N/A Change-Id: I556e53188c60e61a96f76733c3de0ee541b83503 --- .../framework/java/android/app/job/JobParameters.java | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/apex/jobscheduler/framework/java/android/app/job/JobParameters.java b/apex/jobscheduler/framework/java/android/app/job/JobParameters.java index 62c90dfa8a867..e251ff00a47d1 100644 --- a/apex/jobscheduler/framework/java/android/app/job/JobParameters.java +++ b/apex/jobscheduler/framework/java/android/app/job/JobParameters.java @@ -21,6 +21,7 @@ import android.annotation.Nullable; import android.compat.annotation.UnsupportedAppUsage; import android.content.ClipData; import android.net.Network; +import android.net.NetworkRequest; import android.net.Uri; import android.os.Bundle; import android.os.IBinder; @@ -242,8 +243,9 @@ public class JobParameters implements Parcelable { * * @return the network that should be used to perform any network requests * for this job, or {@code null} if this job didn't set any required - * network type. + * network type or if the job executed when there was no available network to use. * @see JobInfo.Builder#setRequiredNetworkType(int) + * @see JobInfo.Builder#setRequiredNetwork(NetworkRequest) */ public @Nullable Network getNetwork() { return network;