diff options
author | Laurent Tu <laurentt@google.com> | 2012-12-05 13:57:01 -0800 |
---|---|---|
committer | Laurent Tu <laurentt@google.com> | 2012-12-05 13:57:01 -0800 |
commit | 578081f9da7ddb056b9b98524c639acd9194ecb6 (patch) | |
tree | ac53b0960f43d8bd6a32f4caa0f6790b6ccf0ad5 /location/lib/README.txt | |
parent | 39ec1ec187c3b27f2819aaf5a3a47819af56e44d (diff) | |
download | frameworks_base-578081f9da7ddb056b9b98524c639acd9194ecb6.zip frameworks_base-578081f9da7ddb056b9b98524c639acd9194ecb6.tar.gz frameworks_base-578081f9da7ddb056b9b98524c639acd9194ecb6.tar.bz2 |
Move location provider lib to frameworks/ex - 1
Move location provider lib to frameworks/ex so it can be re-used in
GmsCore.
This is the frameworks/base part of the change (1).
Change-Id: Ifc31a6809876e9c9afb6ed841b66cf06de7e8964
Diffstat (limited to 'location/lib/README.txt')
-rw-r--r-- | location/lib/README.txt | 30 |
1 files changed, 0 insertions, 30 deletions
diff --git a/location/lib/README.txt b/location/lib/README.txt deleted file mode 100644 index 400a7dd..0000000 --- a/location/lib/README.txt +++ /dev/null @@ -1,30 +0,0 @@ -This library (com.android.location.provider.jar) is a shared java library -containing classes required by unbundled location providers. - ---- Rules of this library --- -o This library is effectively a PUBLIC API for unbundled location providers - that may be distributed outside the system image. So it MUST BE API STABLE. - You can add but not remove. The rules are the same as for the - public platform SDK API. -o This library can see and instantiate internal platform classes (such as - ProviderRequest.java), but it must not expose them in any public method - (or by extending them via inheritance). This would break clients of the - library because they cannot see the internal platform classes. - -This library is distributed in the system image, and loaded as -a shared library. So you can change the implementation, but not -the interface. In this way it is like framework.jar. - ---- Why does this library exists? --- - -Unbundled location providers (such as the NetworkLocationProvider) -can not use internal platform classes. - -So ideally all of these classes would be part of the public platform SDK API, -but that doesn't seem like a great idea when only applications with a special -signature can implement this API. - -The compromise is this library. - -It wraps internal platform classes (like ProviderRequest) with a stable -API that does not leak the internal classes. |