Merge "Expose enableFullTracking API to public" (ada970f4) · Commits · e / os / android_frameworks_base

core/api/current.txt

+15 −0

Original line number	Diff line number	Diff line
		@@ -19069,6 +19069,20 @@ package android.location {
		field public static final int STATE_UNKNOWN = 0; // 0x0
		}

		public final class GnssMeasurementRequest implements android.os.Parcelable {
		method public int describeContents();
		method public boolean isFullTracking();
		method public void writeToParcel(@NonNull android.os.Parcel, int);
		field @NonNull public static final android.os.Parcelable.Creator<android.location.GnssMeasurementRequest> CREATOR;
		}

		public static final class GnssMeasurementRequest.Builder {
		ctor public GnssMeasurementRequest.Builder();
		ctor public GnssMeasurementRequest.Builder(@NonNull android.location.GnssMeasurementRequest);
		method @NonNull public android.location.GnssMeasurementRequest build();
		method @NonNull public android.location.GnssMeasurementRequest.Builder setFullTracking(boolean);
		}

		public final class GnssMeasurementsEvent implements android.os.Parcelable {
		method public int describeContents();
		method @NonNull public android.location.GnssClock getClock();
		@@ -19295,6 +19309,7 @@ package android.location {
		method @Deprecated @RequiresPermission(android.Manifest.permission.ACCESS_FINE_LOCATION) public boolean registerGnssMeasurementsCallback(@NonNull android.location.GnssMeasurementsEvent.Callback);
		method @RequiresPermission(android.Manifest.permission.ACCESS_FINE_LOCATION) public boolean registerGnssMeasurementsCallback(@NonNull android.location.GnssMeasurementsEvent.Callback, @Nullable android.os.Handler);
		method @RequiresPermission(android.Manifest.permission.ACCESS_FINE_LOCATION) public boolean registerGnssMeasurementsCallback(@NonNull java.util.concurrent.Executor, @NonNull android.location.GnssMeasurementsEvent.Callback);
		method @RequiresPermission(android.Manifest.permission.ACCESS_FINE_LOCATION) public boolean registerGnssMeasurementsCallback(@NonNull android.location.GnssMeasurementRequest, @NonNull java.util.concurrent.Executor, @NonNull android.location.GnssMeasurementsEvent.Callback);
		method @Deprecated public boolean registerGnssNavigationMessageCallback(@NonNull android.location.GnssNavigationMessage.Callback);
		method @RequiresPermission(android.Manifest.permission.ACCESS_FINE_LOCATION) public boolean registerGnssNavigationMessageCallback(@NonNull android.location.GnssNavigationMessage.Callback, @Nullable android.os.Handler);
		method @RequiresPermission(android.Manifest.permission.ACCESS_FINE_LOCATION) public boolean registerGnssNavigationMessageCallback(@NonNull java.util.concurrent.Executor, @NonNull android.location.GnssNavigationMessage.Callback);

core/api/system-current.txt

+1 −1

Original line number	Diff line number	Diff line
		@@ -4316,7 +4316,7 @@ package android.location {
		method @Deprecated @RequiresPermission(android.Manifest.permission.READ_DEVICE_CONFIG) public boolean isProviderPackage(@NonNull String);
		method @RequiresPermission(android.Manifest.permission.READ_DEVICE_CONFIG) public boolean isProviderPackage(@Nullable String, @NonNull String);
		method @Deprecated @RequiresPermission(allOf={android.Manifest.permission.LOCATION_HARDWARE, android.Manifest.permission.UPDATE_APP_OPS_STATS}) public boolean registerGnssBatchedLocationCallback(long, boolean, @NonNull android.location.BatchedLocationCallback, @Nullable android.os.Handler);
		method @RequiresPermission(allOf={android.Manifest.permission.ACCESS_FINE_LOCATION, android.Manifest.permission.LOCATION_HARDWARE}) public boolean registerGnssMeasurementsCallback(@NonNull android.location.GnssRequest, @NonNull java.util.concurrent.Executor, @NonNull android.location.GnssMeasurementsEvent.Callback);
		method @Deprecated @RequiresPermission(android.Manifest.permission.ACCESS_FINE_LOCATION) public boolean registerGnssMeasurementsCallback(@NonNull android.location.GnssRequest, @NonNull java.util.concurrent.Executor, @NonNull android.location.GnssMeasurementsEvent.Callback);
		method @Deprecated @RequiresPermission(anyOf={android.Manifest.permission.ACCESS_COARSE_LOCATION, android.Manifest.permission.ACCESS_FINE_LOCATION}) public void requestLocationUpdates(@Nullable android.location.LocationRequest, @NonNull android.location.LocationListener, @Nullable android.os.Looper);
		method @Deprecated @RequiresPermission(anyOf={android.Manifest.permission.ACCESS_COARSE_LOCATION, android.Manifest.permission.ACCESS_FINE_LOCATION}) public void requestLocationUpdates(@Nullable android.location.LocationRequest, @NonNull java.util.concurrent.Executor, @NonNull android.location.LocationListener);
		method @Deprecated @RequiresPermission(anyOf={android.Manifest.permission.ACCESS_COARSE_LOCATION, android.Manifest.permission.ACCESS_FINE_LOCATION}) public void requestLocationUpdates(@Nullable android.location.LocationRequest, @NonNull android.app.PendingIntent);

location/java/android/location/GnssMeasurementRequest.aidl

0 → 100644

+19 −0

Original line number	Diff line number	Diff line
		/*
		* Copyright (C) 2020, The Android Open Source Project
		*
		* Licensed under the Apache License, Version 2.0 (the "License");
		* you may not use this file except in compliance with the License.
		* You may obtain a copy of the License at
		*
		* http://www.apache.org/licenses/LICENSE-2.0
		*
		* Unless required by applicable law or agreed to in writing, software
		* distributed under the License is distributed on an "AS IS" BASIS,
		* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
		* See the License for the specific language governing permissions and
		* limitations under the License.
		*/

		package android.location;

		parcelable GnssMeasurementRequest;

location/java/android/location/GnssMeasurementRequest.java

0 → 100644

+152 −0

Original line number	Diff line number	Diff line
		/*
		* Copyright (C) 2020 The Android Open Source Project
		*
		* Licensed under the Apache License, Version 2.0 (the "License");
		* you may not use this file except in compliance with the License.
		* You may obtain a copy of the License at
		*
		* http://www.apache.org/licenses/LICENSE-2.0
		*
		* Unless required by applicable law or agreed to in writing, software
		* distributed under the License is distributed on an "AS IS" BASIS,
		* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
		* See the License for the specific language governing permissions and
		* limitations under the License.
		*/

		package android.location;

		import android.annotation.NonNull;
		import android.os.Parcel;
		import android.os.Parcelable;

		/**
		* This class contains extra parameters to pass in a GNSS measurement request.
		*/
		public final class GnssMeasurementRequest implements Parcelable {
		private final boolean mFullTracking;

		/**
		* Creates a {@link GnssMeasurementRequest} with a full list of parameters.
		*/
		private GnssMeasurementRequest(boolean fullTracking) {
		mFullTracking = fullTracking;
		}

		/**
		* Represents whether to enable full GNSS tracking.
		*
		* <p>If true, GNSS chipset switches off duty cycling. In such a mode, no clock
		* discontinuities are expected, and when supported, carrier phase should be continuous in
		* good signal conditions. All non-blocklisted, healthy constellations, satellites and
		* frequency bands that the chipset supports must be reported in this mode. The GNSS chipset
		* will consume more power in full tracking mode than in duty cycling mode. If false, GNSS
		* chipset optimizes power via duty cycling, constellations and frequency limits, etc.
		*
		* <p>Full GNSS tracking mode affects GnssMeasurement and other GNSS functionalities
		* including GNSS location.
		*/
		public boolean isFullTracking() {
		return mFullTracking;
		}

		@NonNull
		public static final Creator<GnssMeasurementRequest> CREATOR =
		new Creator<GnssMeasurementRequest>() {
		@Override
		@NonNull
		public GnssMeasurementRequest createFromParcel(@NonNull Parcel parcel) {
		return new GnssMeasurementRequest(parcel.readBoolean());
		}

		@Override
		public GnssMeasurementRequest[] newArray(int i) {
		return new GnssMeasurementRequest[i];
		}
		};

		@Override
		public void writeToParcel(@NonNull Parcel parcel, int flags) {
		parcel.writeBoolean(mFullTracking);
		}

		@NonNull
		@Override
		public String toString() {
		StringBuilder s = new StringBuilder();
		s.append("GnssMeasurementRequest[");
		if (mFullTracking) {
		s.append("FullTracking");
		}
		s.append(']');
		return s.toString();
		}

		@Override
		public boolean equals(Object obj) {
		if (this == obj) return true;
		if (obj == null) return false;
		if (!(obj instanceof GnssMeasurementRequest)) return false;

		GnssMeasurementRequest other = (GnssMeasurementRequest) obj;
		if (mFullTracking != other.mFullTracking) return false;

		return true;
		}

		@Override
		public int hashCode() {
		return mFullTracking ? 1 : 0;
		}

		@Override
		public int describeContents() {
		return 0;
		}

		/** Builder for {@link GnssMeasurementRequest} */
		public static final class Builder {
		private boolean mFullTracking;

		/**
		* Constructs a {@link Builder} instance.
		*/
		public Builder() {
		}

		/**
		* Constructs a {@link Builder} instance by copying a {@link GnssMeasurementRequest}.
		*/
		public Builder(@NonNull GnssMeasurementRequest request) {
		mFullTracking = request.isFullTracking();
		}

		/**
		* Set the value of whether to enable full GNSS tracking, which is false by default.
		*
		* <p>If true, GNSS chipset switches off duty cycling. In such a mode, no clock
		* discontinuities are expected, and when supported, carrier phase should be continuous in
		* good signal conditions. All non-blocklisted, healthy constellations, satellites and
		* frequency bands that the chipset supports must be reported in this mode. The GNSS chipset
		* will consume more power in full tracking mode than in duty cycling mode. If false,
		* GNSS chipset optimizes power via duty cycling, constellations and frequency limits, etc.
		*
		* <p>Full GNSS tracking mode affects GnssMeasurement and other GNSS functionalities
		* including GNSS location.
		*
		* <p>Full tracking requests always override non-full tracking requests. If any full
		* tracking request occurs, all listeners on the device will receive full tracking GNSS
		* measurements.
		*/
		@NonNull public Builder setFullTracking(boolean value) {
		mFullTracking = value;
		return this;
		}

		/** Builds a {@link GnssMeasurementRequest} instance as specified by this builder. */
		@NonNull
		public GnssMeasurementRequest build() {
		return new GnssMeasurementRequest(mFullTracking);
		}
		}
		}

location/java/android/location/GnssRequest.java

+15 −0

Original line number	Diff line number	Diff line
		@@ -45,11 +45,23 @@ public final class GnssRequest implements Parcelable {
		* frequency bands that the chipset supports must be reported in this mode. The GNSS chipset
		* is allowed to consume more power in this mode. If false, GNSS chipset optimizes power via
		* duty cycling, constellations and frequency limits, etc.
		*
		* <p>Full GNSS tracking mode affects GnssMeasurement and other GNSS functionalities
		* including GNSS location.
		*/
		public boolean isFullTracking() {
		return mFullTracking;
		}

		/**
		* Converts the {@link GnssRequest} into a {@link GnssMeasurementRequest}.
		* @hide
		*/
		@NonNull
		public GnssMeasurementRequest toGnssMeasurementRequest() {
		return new GnssMeasurementRequest.Builder().setFullTracking(isFullTracking()).build();
		}

		@NonNull
		public static final Creator<GnssRequest> CREATOR =
		new Creator<GnssRequest>() {
		@@ -131,6 +143,9 @@ public final class GnssRequest implements Parcelable {
		* is allowed to consume more power in this mode. If false, GNSS chipset optimizes power via
		* duty cycling, constellations and frequency limits, etc.
		*
		* <p>Full GNSS tracking mode affects GnssMeasurement and other GNSS functionalities
		* including GNSS location.
		*
		* <p>Full tracking requests always override non-full tracking requests. If any full
		* tracking request occurs, all listeners on the device will receive full tracking GNSS
		* measurements.