summaryrefslogtreecommitdiffstats
path: root/location/lib/README.txt
diff options
context:
space:
mode:
authorLaurent Tu <laurentt@google.com>2012-12-05 13:57:01 -0800
committerLaurent Tu <laurentt@google.com>2012-12-05 13:57:01 -0800
commit578081f9da7ddb056b9b98524c639acd9194ecb6 (patch)
treeac53b0960f43d8bd6a32f4caa0f6790b6ccf0ad5 /location/lib/README.txt
parent39ec1ec187c3b27f2819aaf5a3a47819af56e44d (diff)
downloadframeworks_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.txt30
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.