Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merged-In: I0906de76abf4124d74f7f4f80ac0eab3cbf94f7e

Browse Source 
docs: Revised descriptions of binding and connecting to services.

Clarified that Context.bindService() returning true only indicates
that the system has found a service to bind to the client and that
ServiceConnection.onServiceConnected() might not be called if the
service encounters an error, such as crashing during startup.

Test: make ds-docs

Bug: 63118511
Change-Id: I0906de76abf4124d74f7f4f80ac0eab3cbf94f7e
This commit is contained in:
Kevin Hufnagle
2017-06-29 15:58:48 -07:00
parent 7cb6513f6d
commit d195a9972b
2 changed files with 11 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
core/java/android/content/Context.java
View File

@@ -2822,10 +2822,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. However, you should still call * if the system couldn't find the service or if your client doesn't
* {@link #unbindService} to release the connection. * 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
core/java/android/content/ServiceConnection.java
View File

@@ -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.
* *