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

Commit 0630348f authored by Kevin Hufnagle's avatar Kevin Hufnagle Committed by android-build-merger
Browse files

Merged-In: I0906de76abf4124d74f7f4f80ac0eab3cbf94f7e docs: Revised... 

Merged-In: I0906de76abf4124d74f7f4f80ac0eab3cbf94f7e docs: Revised descriptions of binding and connecting to services. am: d195a997
am: 800e0613

Change-Id: I3854641ab4f80f4bbeae9acd67522fcd8b8484c0
parents c40eccd9 800e0613

core/java/android/content/Context.java

+6 −4
Original line number Diff line number Diff line
@@ -2825,10 +2825,12 @@ public abstract class Context { 
     *          {@link #BIND_NOT_FOREGROUND}, {@link #BIND_ABOVE_CLIENT},

     *          {@link #BIND_ALLOW_OOM_MANAGEMENT}, or

     *          {@link #BIND_WAIVE_PRIORITY}.

     * @return If you have successfully bound to the service, {@code true} is returned;

     *         {@code false} is returned if the connection is not made so you will not

     *         receive the service object. However, you should still call

     *         {@link #unbindService} to release the connection.

     * @return {@code true} if the system is in the process of bringing up a

     *         service that your client has permission to bind to; {@code false}

     *         if the system couldn't find the service or if your client doesn't

     *         have permission to bind to it. If this value is {@code true}, you

     *         should later call {@link #unbindService} to release the

     *         connection.

     *

     * @throws SecurityException If the caller does not have permission to access the service

     * or the service can not be found.

core/java/android/content/ServiceConnection.java

+5 −0
Original line number Diff line number Diff line
@@ -31,6 +31,11 @@ public interface ServiceConnection { 
     * the {@link android.os.IBinder} of the communication channel to the

     * Service.

     *

     * <p class="note"><b>Note:</b> If the system has started to bind your

     * client app to a service, it's possible that your app will never receive

     * this callback. Your app won't receive a callback if there's an issue with

     * the service, such as the service crashing while being created.

     *

     * @param name The concrete component name of the service that has

     * been connected.

     *