diff options
author | Lee Shombert <shombert@google.com> | 2024-04-29 08:57:41 -0700 |
---|---|---|
committer | Lee Shombert <shombert@google.com> | 2024-04-29 09:38:05 -0700 |
commit | 6637da3d58e911b52d024fe5818c9856fc3771b8 (patch) | |
tree | 555536c3af57bce69c7303808bb26711af2de2dc | |
parent | 0e0cc81e9d54c86761c7baffb5fd60e25c381486 (diff) | |
download | sqlite-6637da3d58e911b52d024fe5818c9856fc3771b8.tar.gz |
Update sqlite upgrade documentation
This makes small changes to the sqlite upgrade documentation. As a
bonus change, this also deletes an unused file that should have been
removed when the sqlite build process began using trunk-stable flags.
Test: documentation only
Flag: DOCS_ONLY
Bug: 337329990
Change-Id: Ife1b486ea46e68ab7b9e9d1f9a71c8892da4955d
-rw-r--r-- | README-upgrade.md | 31 | ||||
-rw-r--r-- | README.version | 3 |
2 files changed, 17 insertions, 17 deletions
diff --git a/README-upgrade.md b/README-upgrade.md index c14b1e3..1be4917 100644 --- a/README-upgrade.md +++ b/README-upgrade.md @@ -24,9 +24,9 @@ The upgrade steps are: `UPDATE-SOURCE.bash` may fail if the Android patch cannot be applied cleanly. If this happens, correct the patch failures by hand and rebuild the Android patch file. Use the script `REBUILD-ANDROID-PATCH.bash` to rebuild the patch file. -This script takes the same arguments as `UPDATE-SOURCE.bash`. Then rerun -`UPDATE-SOURCE.bash`. It is important that `UPDATE-SOURCE.bash` run without -errors. +This script takes a single argument which is the same version number that was +given to `UPDATE-SOURCE.bash`. Then rerun `UPDATE-SOURCE.bash`. It is important +that `UPDATE-SOURCE.bash` run without errors. Once the scripts have completed, there will be a directory containing the new source files. The directory is named after the sqlite release and exists in @@ -40,15 +40,16 @@ is `RELEASE_PACKAGE_LIBSQLITE3`. The value of that flag is the 7-digit sqlite release number (e.g., 3420000). Any target that respects trunk-stable flags will use the source in `external/sqlite/dist/sqlite-autoconf-FLAG`. Not all targets respect the trunk-stable flags, however. Such targets use the directory -`external/sqlite/dist/sqlite-default`. +`external/sqlite/dist/sqlite-default`. A new release of sqlite can be promoted to `trunk` by setting the flag to the -proper release string. +proper release string. Once a new release of sqlite has been promoted to +`next`, it is best practice to change the symbolic link `sqlite-default` to +point to the new release. This ensures that any target that does not honor +build flags will use the newly promoted release. -A release of sqlite is promoted to `next` by setting the flag to the release -string AND by copying the associated release directory to `sqlite-default`. -This moves all targets that do not honor build flags to use the newly promoted -release. +Finally, after the new sqlite release has been delivered in an Android update, +old sqlite release directories can be deleted. ## LICENSE @@ -74,12 +75,14 @@ well and it must be updated within `aosp-main` at the same time as the source. cts/tests/tests/database/src/android/database/sqlite/cts/SQLiteDatabaseTest.java ``` -Update the following two constants (the values below are for SQLite 3.42.0). +Find and update the function `testSqliteLibraryVersion()`. This function must +be updated as soon as a new sqlite release is installed in `trunk_staging`, and +the function must accept old and new sqlite releases. Once a new release has +been committed to `next`, old releases can be rejected by this function. -```java - static final String EXPECTED_MAJOR_MINOR_VERSION = "3.42"; - static final int EXPECTED_MIN_PATCH_LEVEL = 0; -``` +Note that the CTS test is sometimes propagated to branches for older Android +releases, which do not use the latest sqlite release. If that happens, the CTS +test will have to accept both the old and new sqlite releases. ## package.html diff --git a/README.version b/README.version deleted file mode 100644 index 99c39d5..0000000 --- a/README.version +++ /dev/null @@ -1,3 +0,0 @@ -URL: https://sqlite.org/2023/sqlite-autoconf-3420000.tar.gz -Version: 3.42.0 -BugComponent: 24950 |