Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit e8abe8e5 authored by Lifu Tang's avatar Lifu Tang
Browse files

Addressed API review comments and updated JavaDoc 

Bug: 27274532
Bug: 27948390
Change-Id: I0255d2511deab788dcab9815def9c1287a50b7f9
parent 36712853

api/current.txt

+31 −40
Original line number Diff line number Diff line
@@ -19214,7 +19214,7 @@ package android.location { 
    field public static final int ADR_STATE_VALID = 1; // 0x1

    field public static final android.os.Parcelable.Creator<android.location.GnssMeasurement> CREATOR;

    field public static final int MULTIPATH_INDICATOR_DETECTED = 1; // 0x1

    field public static final int MULTIPATH_INDICATOR_NOT_USED = 2; // 0x2

    field public static final int MULTIPATH_INDICATOR_NOT_DETECTED = 2; // 0x2

    field public static final int MULTIPATH_INDICATOR_UNKNOWN = 0; // 0x0

    field public static final int STATE_BDS_D2_BIT_SYNC = 256; // 0x100

    field public static final int STATE_BDS_D2_SUBFRAME_SYNC = 512; // 0x200
@@ -19234,21 +19234,20 @@ package android.location { 
  }















  public final class GnssMeasurementsEvent implements android.os.Parcelable {













    ctor public GnssMeasurementsEvent(android.location.GnssClock, android.location.GnssMeasurement[]);















    method public int describeContents();















    method public android.location.GnssClock getClock();















    method public java.util.Collection<android.location.GnssMeasurement> getMeasurements();















    method public void writeToParcel(android.os.Parcel, int);















    field public static final android.os.Parcelable.Creator<android.location.GnssMeasurementsEvent> CREATOR;













    field public static final int STATUS_GNSS_LOCATION_DISABLED = 2; // 0x2













    field public static final int STATUS_NOT_SUPPORTED = 0; // 0x0













    field public static final int STATUS_READY = 1; // 0x1















  }





























  public static abstract class GnssMeasurementsEvent.Callback {















    ctor public GnssMeasurementsEvent.Callback();















    method public void onGnssMeasurementsReceived(android.location.GnssMeasurementsEvent);















    method public void onStatusChanged(int);













    field public static final int STATUS_LOCATION_DISABLED = 2; // 0x2













    field public static final int STATUS_NOT_SUPPORTED = 0; // 0x0













    field public static final int STATUS_READY = 1; // 0x1















  }





























  public final class GnssNavigationMessage implements android.os.Parcelable {










@@ -19276,36 +19275,24 @@ package android.location {













    field public static final int TYPE_UNKNOWN = 0; // 0x0















  }



























  public final class GnssNavigationMessageEvent implements android.os.Parcelable {













    ctor public GnssNavigationMessageEvent(android.location.GnssNavigationMessage);













    method public int describeContents();













    method public android.location.GnssNavigationMessage getNavigationMessage();













    method public void writeToParcel(android.os.Parcel, int);













    field public static final android.os.Parcelable.Creator<android.location.GnssNavigationMessageEvent> CREATOR;













    field public static final int STATUS_GNSS_LOCATION_DISABLED = 2; // 0x2













  public static abstract class GnssNavigationMessage.Callback {













    ctor public GnssNavigationMessage.Callback();













    method public void onGnssNavigationMessageReceived(android.location.GnssNavigationMessage);













    method public void onStatusChanged(int);













    field public static final int STATUS_LOCATION_DISABLED = 2; // 0x2















    field public static final int STATUS_NOT_SUPPORTED = 0; // 0x0















    field public static final int STATUS_READY = 1; // 0x1















  }



























  public static abstract class GnssNavigationMessageEvent.Callback {













    ctor public GnssNavigationMessageEvent.Callback();













    method public void onGnssNavigationMessageReceived(android.location.GnssNavigationMessageEvent);













    method public void onStatusChanged(int);













  }

























  public abstract interface GnssNmeaListener {













    method public abstract void onNmeaReceived(long, java.lang.String);













  }



























  public final class GnssStatus {















    method public float getAzimuthDegrees(int);















    method public float getCn0DbHz(int);















    method public int getConstellationType(int);















    method public float getElevationDegrees(int);













    method public int getNumSatellites();













    method public int getSatelliteCount();















    method public int getSvid(int);













    method public boolean hasAlmanac(int);













    method public boolean hasEphemeris(int);













    method public boolean hasAlmanacData(int);













    method public boolean hasEphemerisData(int);















    method public boolean usedInFix(int);















    field public static final int CONSTELLATION_BEIDOU = 5; // 0x5















    field public static final int CONSTELLATION_GALILEO = 6; // 0x6









@@ -19316,15 +19303,15 @@ package android.location {













    field public static final int CONSTELLATION_UNKNOWN = 0; // 0x0















  }



























  public abstract class GnssStatusCallback {













    ctor public GnssStatusCallback();













  public static abstract class GnssStatus.Callback {













    ctor public GnssStatus.Callback();















    method public void onFirstFix(int);















    method public void onSatelliteStatusChanged(android.location.GnssStatus);















    method public void onStarted();















    method public void onStopped();















  }



























  public final class GpsSatellite {













  public final deprecated class GpsSatellite {















    method public float getAzimuth();















    method public float getElevation();















    method public int getPrn();









@@ -19334,7 +19321,7 @@ package android.location {













    method public boolean usedInFix();















  }



























  public final class GpsStatus {













  public final deprecated class GpsStatus {















    method public int getMaxSatellites();















    method public java.lang.Iterable<android.location.GpsSatellite> getSatellites();















    method public int getTimeToFirstFix();









@@ -19344,11 +19331,11 @@ package android.location {













    field public static final int GPS_EVENT_STOPPED = 2; // 0x2















  }



























  public static abstract interface GpsStatus.Listener {













  public static abstract deprecated interface GpsStatus.Listener {















    method public abstract void onGpsStatusChanged(int);















  }



























  public static abstract interface GpsStatus.NmeaListener {













  public static abstract deprecated interface GpsStatus.NmeaListener {















    method public abstract void onNmeaReceived(long, java.lang.String);















  }
























@@ -19410,8 +19397,8 @@ package android.location {













  public class LocationManager {















    method public deprecated boolean addGpsStatusListener(android.location.GpsStatus.Listener);















    method public deprecated boolean addNmeaListener(android.location.GpsStatus.NmeaListener);













    method public boolean addNmeaListener(android.location.GnssNmeaListener);













    method public boolean addNmeaListener(android.location.GnssNmeaListener, android.os.Handler);













    method public boolean addNmeaListener(android.location.OnNmeaMessageListener);













    method public boolean addNmeaListener(android.location.OnNmeaMessageListener, android.os.Handler);















    method public void addProximityAlert(double, double, float, long, android.app.PendingIntent);















    method public void addTestProvider(java.lang.String, boolean, boolean, boolean, boolean, boolean, boolean, boolean, int, int);















    method public void clearTestProviderEnabled(java.lang.String);









@@ -19427,13 +19414,13 @@ package android.location {













    method public boolean isProviderEnabled(java.lang.String);















    method public boolean registerGnssMeasurementsCallback(android.location.GnssMeasurementsEvent.Callback);















    method public boolean registerGnssMeasurementsCallback(android.location.GnssMeasurementsEvent.Callback, android.os.Handler);













    method public boolean registerGnssNavigationMessageCallback(android.location.GnssNavigationMessageEvent.Callback);













    method public boolean registerGnssNavigationMessageCallback(android.location.GnssNavigationMessageEvent.Callback, android.os.Handler);













    method public boolean registerGnssStatusCallback(android.location.GnssStatusCallback);













    method public boolean registerGnssStatusCallback(android.location.GnssStatusCallback, android.os.Handler);













    method public boolean registerGnssNavigationMessageCallback(android.location.GnssNavigationMessage.Callback);













    method public boolean registerGnssNavigationMessageCallback(android.location.GnssNavigationMessage.Callback, android.os.Handler);













    method public boolean registerGnssStatusCallback(android.location.GnssStatus.Callback);













    method public boolean registerGnssStatusCallback(android.location.GnssStatus.Callback, android.os.Handler);















    method public deprecated void removeGpsStatusListener(android.location.GpsStatus.Listener);















    method public deprecated void removeNmeaListener(android.location.GpsStatus.NmeaListener);













    method public void removeNmeaListener(android.location.GnssNmeaListener);













    method public void removeNmeaListener(android.location.OnNmeaMessageListener);















    method public void removeProximityAlert(android.app.PendingIntent);















    method public void removeTestProvider(java.lang.String);















    method public void removeUpdates(android.location.LocationListener);









@@ -19452,8 +19439,8 @@ package android.location {













    method public void setTestProviderLocation(java.lang.String, android.location.Location);















    method public void setTestProviderStatus(java.lang.String, int, android.os.Bundle, long);















    method public void unregisterGnssMeasurementsCallback(android.location.GnssMeasurementsEvent.Callback);













    method public void unregisterGnssNavigationMessageCallback(android.location.GnssNavigationMessageEvent.Callback);













    method public void unregisterGnssStatusCallback(android.location.GnssStatusCallback);













    method public void unregisterGnssNavigationMessageCallback(android.location.GnssNavigationMessage.Callback);













    method public void unregisterGnssStatusCallback(android.location.GnssStatus.Callback);















    field public static final java.lang.String GPS_PROVIDER = "gps";















    field public static final java.lang.String KEY_LOCATION_CHANGED = "location";















    field public static final java.lang.String KEY_PROVIDER_ENABLED = "providerEnabled";










@@ -19482,6 +19469,10 @@ package android.location {













    field public static final int TEMPORARILY_UNAVAILABLE = 1; // 0x1















  }



























  public abstract interface OnNmeaMessageListener {













    method public abstract void onNmeaMessage(java.lang.String, long);













  }



























  public abstract class SettingInjectorService extends android.app.Service {















    ctor public SettingInjectorService(java.lang.String);















    method public final android.os.IBinder onBind(android.content.Intent);

























api/removed.txt



+61
−0




























Original line number
Diff line number
Diff line








@@ -84,6 +84,67 @@ package android.graphics {





























}





























package android.location {



























  public final class GnssMeasurement implements android.os.Parcelable {













    field public static final int MULTIPATH_INDICATOR_NOT_USED = 2; // 0x2













  }



























  public final class GnssMeasurementsEvent implements android.os.Parcelable {













    field public static final int STATUS_GNSS_LOCATION_DISABLED = 2; // 0x2













    field public static final int STATUS_NOT_SUPPORTED = 0; // 0x0













    field public static final int STATUS_READY = 1; // 0x1













  }



























  public final class GnssNavigationMessageEvent implements android.os.Parcelable {













    ctor public GnssNavigationMessageEvent(android.location.GnssNavigationMessage);













    method public int describeContents();













    method public android.location.GnssNavigationMessage getNavigationMessage();













    method public void writeToParcel(android.os.Parcel, int);













    field public static final android.os.Parcelable.Creator<android.location.GnssNavigationMessageEvent> CREATOR;













    field public static final int STATUS_GNSS_LOCATION_DISABLED = 2; // 0x2













    field public static final int STATUS_NOT_SUPPORTED = 0; // 0x0













    field public static final int STATUS_READY = 1; // 0x1













  }



























  public static abstract class GnssNavigationMessageEvent.Callback {













    ctor public GnssNavigationMessageEvent.Callback();













    method public void onGnssNavigationMessageReceived(android.location.GnssNavigationMessageEvent);













    method public void onStatusChanged(int);













  }



























  public abstract interface GnssNmeaListener {













    method public abstract void onNmeaReceived(long, java.lang.String);













  }



























  public final class GnssStatus {













    method public int getNumSatellites();













    method public boolean hasAlmanac(int);













    method public boolean hasEphemeris(int);













  }



























  public abstract class GnssStatusCallback {













    ctor public GnssStatusCallback();













    method public void onFirstFix(int);













    method public void onSatelliteStatusChanged(android.location.GnssStatus);













    method public void onStarted();













    method public void onStopped();













  }



























  public class LocationManager {













    method public boolean addNmeaListener(android.location.GnssNmeaListener);













    method public boolean addNmeaListener(android.location.GnssNmeaListener, android.os.Handler);













    method public boolean registerGnssNavigationMessageCallback(android.location.GnssNavigationMessageEvent.Callback);













    method public boolean registerGnssNavigationMessageCallback(android.location.GnssNavigationMessageEvent.Callback, android.os.Handler);













    method public boolean registerGnssStatusCallback(android.location.GnssStatusCallback);













    method public boolean registerGnssStatusCallback(android.location.GnssStatusCallback, android.os.Handler);













    method public void removeNmeaListener(android.location.GnssNmeaListener);













    method public void unregisterGnssNavigationMessageCallback(android.location.GnssNavigationMessageEvent.Callback);













    method public void unregisterGnssStatusCallback(android.location.GnssStatusCallback);













  }



























}





























package android.media {































  public final class AudioFormat implements android.os.Parcelable {

































api/system-current.txt



+31
−40




























Original line number
Diff line number
Diff line








@@ -20374,7 +20374,7 @@ package android.location {













    field public static final int ADR_STATE_VALID = 1; // 0x1















    field public static final android.os.Parcelable.Creator<android.location.GnssMeasurement> CREATOR;















    field public static final int MULTIPATH_INDICATOR_DETECTED = 1; // 0x1













    field public static final int MULTIPATH_INDICATOR_NOT_USED = 2; // 0x2













    field public static final int MULTIPATH_INDICATOR_NOT_DETECTED = 2; // 0x2















    field public static final int MULTIPATH_INDICATOR_UNKNOWN = 0; // 0x0















    field public static final int STATE_BDS_D2_BIT_SYNC = 256; // 0x100















    field public static final int STATE_BDS_D2_SUBFRAME_SYNC = 512; // 0x200









@@ -20394,21 +20394,20 @@ package android.location {













  }





























  public final class GnssMeasurementsEvent implements android.os.Parcelable {













    ctor public GnssMeasurementsEvent(android.location.GnssClock, android.location.GnssMeasurement[]);















    method public int describeContents();















    method public android.location.GnssClock getClock();















    method public java.util.Collection<android.location.GnssMeasurement> getMeasurements();















    method public void writeToParcel(android.os.Parcel, int);















    field public static final android.os.Parcelable.Creator<android.location.GnssMeasurementsEvent> CREATOR;













    field public static final int STATUS_GNSS_LOCATION_DISABLED = 2; // 0x2













    field public static final int STATUS_NOT_SUPPORTED = 0; // 0x0













    field public static final int STATUS_READY = 1; // 0x1















  }





























  public static abstract class GnssMeasurementsEvent.Callback {















    ctor public GnssMeasurementsEvent.Callback();















    method public void onGnssMeasurementsReceived(android.location.GnssMeasurementsEvent);















    method public void onStatusChanged(int);













    field public static final int STATUS_LOCATION_DISABLED = 2; // 0x2













    field public static final int STATUS_NOT_SUPPORTED = 0; // 0x0













    field public static final int STATUS_READY = 1; // 0x1















  }





























  public final class GnssNavigationMessage implements android.os.Parcelable {










@@ -20436,36 +20435,24 @@ package android.location {













    field public static final int TYPE_UNKNOWN = 0; // 0x0















  }



























  public final class GnssNavigationMessageEvent implements android.os.Parcelable {













    ctor public GnssNavigationMessageEvent(android.location.GnssNavigationMessage);













    method public int describeContents();













    method public android.location.GnssNavigationMessage getNavigationMessage();













    method public void writeToParcel(android.os.Parcel, int);













    field public static final android.os.Parcelable.Creator<android.location.GnssNavigationMessageEvent> CREATOR;













    field public static final int STATUS_GNSS_LOCATION_DISABLED = 2; // 0x2













  public static abstract class GnssNavigationMessage.Callback {













    ctor public GnssNavigationMessage.Callback();













    method public void onGnssNavigationMessageReceived(android.location.GnssNavigationMessage);













    method public void onStatusChanged(int);













    field public static final int STATUS_LOCATION_DISABLED = 2; // 0x2















    field public static final int STATUS_NOT_SUPPORTED = 0; // 0x0















    field public static final int STATUS_READY = 1; // 0x1















  }



























  public static abstract class GnssNavigationMessageEvent.Callback {













    ctor public GnssNavigationMessageEvent.Callback();













    method public void onGnssNavigationMessageReceived(android.location.GnssNavigationMessageEvent);













    method public void onStatusChanged(int);













  }

























  public abstract interface GnssNmeaListener {













    method public abstract void onNmeaReceived(long, java.lang.String);













  }



























  public final class GnssStatus {















    method public float getAzimuthDegrees(int);















    method public float getCn0DbHz(int);















    method public int getConstellationType(int);















    method public float getElevationDegrees(int);













    method public int getNumSatellites();













    method public int getSatelliteCount();















    method public int getSvid(int);













    method public boolean hasAlmanac(int);













    method public boolean hasEphemeris(int);













    method public boolean hasAlmanacData(int);













    method public boolean hasEphemerisData(int);















    method public boolean usedInFix(int);















    field public static final int CONSTELLATION_BEIDOU = 5; // 0x5















    field public static final int CONSTELLATION_GALILEO = 6; // 0x6









@@ -20476,8 +20463,8 @@ package android.location {













    field public static final int CONSTELLATION_UNKNOWN = 0; // 0x0















  }



























  public abstract class GnssStatusCallback {













    ctor public GnssStatusCallback();













  public static abstract class GnssStatus.Callback {













    ctor public GnssStatus.Callback();















    method public void onFirstFix(int);















    method public void onSatelliteStatusChanged(android.location.GnssStatus);















    method public void onStarted();










@@ -20709,7 +20696,7 @@ package android.location {













    method public abstract void onStatusChanged(int);















  }



























  public final class GpsSatellite {













  public final deprecated class GpsSatellite {















    method public float getAzimuth();















    method public float getElevation();















    method public int getPrn();









@@ -20719,7 +20706,7 @@ package android.location {













    method public boolean usedInFix();















  }



























  public final class GpsStatus {













  public final deprecated class GpsStatus {















    method public int getMaxSatellites();















    method public java.lang.Iterable<android.location.GpsSatellite> getSatellites();















    method public int getTimeToFirstFix();









@@ -20729,11 +20716,11 @@ package android.location {













    field public static final int GPS_EVENT_STOPPED = 2; // 0x2















  }



























  public static abstract interface GpsStatus.Listener {













  public static abstract deprecated interface GpsStatus.Listener {















    method public abstract void onGpsStatusChanged(int);















  }



























  public static abstract interface GpsStatus.NmeaListener {













  public static abstract deprecated interface GpsStatus.NmeaListener {















    method public abstract void onNmeaReceived(long, java.lang.String);















  }
























@@ -20817,8 +20804,8 @@ package android.location {













    method public deprecated boolean addGpsNavigationMessageListener(android.location.GpsNavigationMessageEvent.Listener);















    method public deprecated boolean addGpsStatusListener(android.location.GpsStatus.Listener);















    method public deprecated boolean addNmeaListener(android.location.GpsStatus.NmeaListener);













    method public boolean addNmeaListener(android.location.GnssNmeaListener);













    method public boolean addNmeaListener(android.location.GnssNmeaListener, android.os.Handler);













    method public boolean addNmeaListener(android.location.OnNmeaMessageListener);













    method public boolean addNmeaListener(android.location.OnNmeaMessageListener, android.os.Handler);















    method public void addProximityAlert(double, double, float, long, android.app.PendingIntent);















    method public void addTestProvider(java.lang.String, boolean, boolean, boolean, boolean, boolean, boolean, boolean, int, int);















    method public void clearTestProviderEnabled(java.lang.String);









@@ -20834,15 +20821,15 @@ package android.location {













    method public boolean isProviderEnabled(java.lang.String);















    method public boolean registerGnssMeasurementsCallback(android.location.GnssMeasurementsEvent.Callback);















    method public boolean registerGnssMeasurementsCallback(android.location.GnssMeasurementsEvent.Callback, android.os.Handler);













    method public boolean registerGnssNavigationMessageCallback(android.location.GnssNavigationMessageEvent.Callback);













    method public boolean registerGnssNavigationMessageCallback(android.location.GnssNavigationMessageEvent.Callback, android.os.Handler);













    method public boolean registerGnssStatusCallback(android.location.GnssStatusCallback);













    method public boolean registerGnssStatusCallback(android.location.GnssStatusCallback, android.os.Handler);













    method public boolean registerGnssNavigationMessageCallback(android.location.GnssNavigationMessage.Callback);













    method public boolean registerGnssNavigationMessageCallback(android.location.GnssNavigationMessage.Callback, android.os.Handler);













    method public boolean registerGnssStatusCallback(android.location.GnssStatus.Callback);













    method public boolean registerGnssStatusCallback(android.location.GnssStatus.Callback, android.os.Handler);















    method public deprecated void removeGpsMeasurementListener(android.location.GpsMeasurementsEvent.Listener);















    method public deprecated void removeGpsNavigationMessageListener(android.location.GpsNavigationMessageEvent.Listener);















    method public deprecated void removeGpsStatusListener(android.location.GpsStatus.Listener);















    method public deprecated void removeNmeaListener(android.location.GpsStatus.NmeaListener);













    method public void removeNmeaListener(android.location.GnssNmeaListener);













    method public void removeNmeaListener(android.location.OnNmeaMessageListener);















    method public void removeProximityAlert(android.app.PendingIntent);















    method public void removeTestProvider(java.lang.String);















    method public void removeUpdates(android.location.LocationListener);









@@ -20863,8 +20850,8 @@ package android.location {













    method public void setTestProviderLocation(java.lang.String, android.location.Location);















    method public void setTestProviderStatus(java.lang.String, int, android.os.Bundle, long);















    method public void unregisterGnssMeasurementsCallback(android.location.GnssMeasurementsEvent.Callback);













    method public void unregisterGnssNavigationMessageCallback(android.location.GnssNavigationMessageEvent.Callback);













    method public void unregisterGnssStatusCallback(android.location.GnssStatusCallback);













    method public void unregisterGnssNavigationMessageCallback(android.location.GnssNavigationMessage.Callback);













    method public void unregisterGnssStatusCallback(android.location.GnssStatus.Callback);















    field public static final java.lang.String GPS_PROVIDER = "gps";















    field public static final java.lang.String KEY_LOCATION_CHANGED = "location";















    field public static final java.lang.String KEY_PROVIDER_ENABLED = "providerEnabled";










@@ -20927,6 +20914,10 @@ package android.location {













    field public static final int POWER_NONE = 200; // 0xc8















  }



























  public abstract interface OnNmeaMessageListener {













    method public abstract void onNmeaMessage(java.lang.String, long);













  }



























  public abstract class SettingInjectorService extends android.app.Service {















    ctor public SettingInjectorService(java.lang.String);















    method public final android.os.IBinder onBind(android.content.Intent);

























api/system-removed.txt



+61
−0


























File changed.
Preview size limit exceeded, changes collapsed.
























api/test-current.txt



+31
−39


























File changed.
Preview size limit exceeded, changes collapsed.