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

Commit 742bacc9 authored by Kevin Hufnagle's avatar Kevin Hufnagle Committed by Android (Google) Code Review
Browse files

Merge "docs: Revised descriptions of binding and connecting to services."

parents ce3d17d3 34acbc9b
Loading
Loading
Loading
Loading
+6 −4
Original line number Original line Diff line number Diff line
@@ -2851,10 +2851,12 @@ public abstract class Context {
     *          {@link #BIND_NOT_FOREGROUND}, {@link #BIND_ABOVE_CLIENT},
     *          {@link #BIND_NOT_FOREGROUND}, {@link #BIND_ABOVE_CLIENT},
     *          {@link #BIND_ALLOW_OOM_MANAGEMENT}, or
     *          {@link #BIND_ALLOW_OOM_MANAGEMENT}, or
     *          {@link #BIND_WAIVE_PRIORITY}.
     *          {@link #BIND_WAIVE_PRIORITY}.
     * @return If you have successfully bound to the service, {@code true} is returned;
     * @return {@code true} if the system is in the process of bringing up a
     *         {@code false} is returned if the connection is not made so you will not
     *         service that your client has permission to bind to; {@code false}
     *         receive the service object. You should still call {@link #unbindService}
     *         if the system couldn't find the service or if your client doesn't
     *         to release the connection even if this method returned {@code false}.
     *         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
     * @throws SecurityException If the caller does not have permission to access the service
     * or the service can not be found.
     * or the service can not be found.
+5 −0
Original line number Original line Diff line number Diff line
@@ -31,6 +31,11 @@ public interface ServiceConnection {
     * the {@link android.os.IBinder} of the communication channel to the
     * the {@link android.os.IBinder} of the communication channel to the
     * Service.
     * 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
     * @param name The concrete component name of the service that has
     * been connected.
     * been connected.
     *
     *