Index: chrome/android/webapk/libs/runtime_library/src/README |
diff --git a/chrome/android/webapk/libs/runtime_library/src/README b/chrome/android/webapk/libs/runtime_library/src/README |
new file mode 100644 |
index 0000000000000000000000000000000000000000..793edf43262e62866dc24998af1937a2e315b408 |
--- /dev/null |
+++ b/chrome/android/webapk/libs/runtime_library/src/README |
@@ -0,0 +1,18 @@ |
+The runtime library contains the implementation of the Web APK service. It |
+implements functionality which Chrome delegates to the Web APK such as |
+displaying notifications. The library is loaded by a ShellAPK which |
+contains the Web APK's manifest and code to load the runtime library. |
+ |
+The latest version of the runtime library is |
+extracted from Chrome's APK by the ShellAPK when the Web APK service is created. |
+Since the ShellAPK is updated asynchronously, the runtime library may run within |
+an old ShellAPK. For instance, the ShellAPK's Android manifest may be missing |
+some of the permissions that the runtime library is expecting. |
+ |
+As the runtime library code does not execute in any of Chrome's processes, and |
+runs in a separate application/process, it must not depend on anything in Chrome |
+including //base. |
+ |
+The number in runtime_library_version.gni must be incremented whenever the |
+runtime library is updated. The WebAPK re-extracts the runtime library from the |
+Chrome APK when the version number is incremented. |