summaryrefslogtreecommitdiff
path: root/static/build.html
diff options
context:
space:
mode:
authorDaniel Micay <danielmicay@gmail.com>2020-06-05 22:12:02 -0400
committerDaniel Micay <danielmicay@gmail.com>2020-06-05 22:12:02 -0400
commit90f4c364f3afa5bf5f4db873d522b0cbecd89c29 (patch)
treea0b48e0a52a0840ce1b07c8e97a08faca7c560fe /static/build.html
parent2d5d633f18c188169fdeaed61092ac69d8cb5c17 (diff)
explain update server metadata
Diffstat (limited to 'static/build.html')
-rw-r--r--static/build.html18
1 files changed, 18 insertions, 0 deletions
diff --git a/static/build.html b/static/build.html
index 86db00d6..42c3edb9 100644
--- a/static/build.html
+++ b/static/build.html
@@ -644,6 +644,24 @@ cd ../..</pre>
factory images. See the <a href="/usage#updates-sideloading">usage guide section on
sideloading updates</a> for information on how to use the update packages.</p>
+ <p>Running <code>script/release.sh</code> also generates channel metadata for the
+ update server. If you configured the Updater client URL and set the build to include
+ it (see the information on <code>OFFICIAL_BUILD</code> above), you can push signed
+ over-the-air updates via the update system. Simply upload the update package to the
+ update server along with the channel metadata for the release channel, and it will be
+ pushed out to the update client. The <code>$DEVICE-beta</code> and
+ <code>$DEVICE-stable</code> metadata provide the Beta and Stable release channels used
+ by the update client. The <code>$DEVICE-testing</code> metadata provides
+ provides an internal testing channel for the OS developers, which can be temporarily
+ enabled using <code>adb shell setprop sys.update.channel testing</code>. The name is
+ arbitrary and you can also use any other name for internal testing channels. For
+ GrapheneOS itself, the testing channel is used to push out updates to developer
+ devices, followed by a sample future release to test that the release which is about
+ to be pushed out to the Beta channel is able to update to a future release. Once it's
+ tested internally, the release is pushed out to the Beta channel, and finally to the
+ Stable channel after public testing. A similar approach is recommended for derivatives
+ of GrapheneOS.</p>
+
<h4 id="generating-delta-updates">
<a href="#generating-delta-updates">Generating delta updates</a>
</h4>