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

Commit f950c08b authored by Andrei Onea's avatar Andrei Onea
Browse files

Document public alternatives to greylisted APIs 

Add known public alternatives or recommendations for greylisted APIs in
Bluetooth.

Bug: 135171386
Test: m
Change-Id: I86e708be37eb7d1b0fafa2d64283b7f81bc02e51
parent 56dbf7cc

core/java/android/bluetooth/BluetoothAdapter.java

+4 −2
Original line number Diff line number Diff line
@@ -1028,7 +1028,8 @@ public final class BluetoothAdapter { 
     */

    @RequiresPermission(Manifest.permission.BLUETOOTH)

    @AdapterState

    @UnsupportedAppUsage

    @UnsupportedAppUsage(publicAlternatives = "Use {@link #getState()} instead to determine "

            + "whether you can use BLE & BT classic.")

    public int getLeState() {

        int state = BluetoothAdapter.STATE_OFF;
@@ -1484,7 +1485,8 @@ public final class BluetoothAdapter { 
     * @return true if the scan mode was set, false otherwise

     * @hide

     */

    @UnsupportedAppUsage

    @UnsupportedAppUsage(publicAlternatives = "Use {@link #ACTION_REQUEST_DISCOVERABLE}, which "

            + "shows UI that confirms the user wants to go into discoverable mode.")

    public boolean setScanMode(@ScanMode int mode, int duration) {

        if (getState() != STATE_ON) {

            return false;

core/java/android/bluetooth/BluetoothDevice.java

+4 −3
Original line number Diff line number Diff line
@@ -1051,7 +1051,7 @@ public final class BluetoothDevice implements Parcelable { 
     * @return the Bluetooth alias, or null if no alias or there was a problem

     * @hide

     */

    @UnsupportedAppUsage

    @UnsupportedAppUsage(publicAlternatives = "Use {@link #getName()} instead.")

    public String getAlias() {

        final IBluetooth service = sService;

        if (service == null) {
@@ -1100,7 +1100,7 @@ public final class BluetoothDevice implements Parcelable { 
     * @see #getAlias()

     * @see #getName()

     */

    @UnsupportedAppUsage

    @UnsupportedAppUsage(publicAlternatives = "Use {@link #getName()} instead.")

    public String getAliasName() {

        String name = getAlias();

        if (name == null) {
@@ -1975,7 +1975,8 @@ public final class BluetoothDevice implements Parcelable { 
     * permissions.

     * @hide

     */

    @UnsupportedAppUsage

    @UnsupportedAppUsage(publicAlternatives = "Use "

            + "{@link #createInsecureRfcommSocketToServiceRecord} instead.")

    public BluetoothSocket createInsecureRfcommSocket(int port) throws IOException {

        if (!isBluetoothEnabled()) {

            Log.e(TAG, "Bluetooth is not enabled");

core/java/android/bluetooth/BluetoothServerSocket.java

+2 −1
Original line number Diff line number Diff line
@@ -77,7 +77,8 @@ public final class BluetoothServerSocket implements Closeable { 


    private static final String TAG = "BluetoothServerSocket";

    private static final boolean DBG = false;

    @UnsupportedAppUsage

    @UnsupportedAppUsage(publicAlternatives = "Use public {@link BluetoothServerSocket} API "

            + "instead.")

    /*package*/ final BluetoothSocket mSocket;

    private Handler mHandler;

    private int mMessage;

core/java/android/bluetooth/BluetoothSocket.java

+1 −1
Original line number Diff line number Diff line
@@ -131,7 +131,7 @@ public final class BluetoothSocket implements Closeable { 
    private boolean mExcludeSdp = false; /* when true no SPP SDP record will be created */

    private boolean mAuthMitm = false;   /* when true Man-in-the-middle protection will be enabled*/

    private boolean mMin16DigitPin = false; /* Minimum 16 digit pin for sec mode 2 connections */

    @UnsupportedAppUsage

    @UnsupportedAppUsage(publicAlternatives = "Use {@link BluetoothSocket} public API instead.")

    private ParcelFileDescriptor mPfd;

    @UnsupportedAppUsage

    private LocalSocket mSocket;