summaryrefslogtreecommitdiff
path: root/static
diff options
context:
space:
mode:
authorDaniel Micay <danielmicay@gmail.com>2020-04-07 06:10:23 -0400
committerDaniel Micay <danielmicay@gmail.com>2020-04-07 06:10:23 -0400
commitae199533746a02e84a9c5022cc6a272a0ae428ad (patch)
tree06c5219b76174bfcac2e1af1449488f5d46fe63c /static
parent095ac5c340dd16d78a5f98ccf91c04c71aba71ae (diff)
explain OFFICIAL_BUILD environment variable
Diffstat (limited to 'static')
-rw-r--r--static/build.html16
1 files changed, 16 insertions, 0 deletions
diff --git a/static/build.html b/static/build.html
index 95015a39..6483fe3c 100644
--- a/static/build.html
+++ b/static/build.html
@@ -334,6 +334,17 @@ git submodule update --init
should be <code>user</code> builds as they are significantly more secure and don't
make additional performance sacrifices to improve debugging.</p>
+ <p>Set <code>OFFICIAL_BUILD=true</code> to include the Updater app. You
+ <strong>must</strong> change the URL in
+ <code>packages/apps/Updater/res/values/config.xml</code> to your own domain. Using the
+ official update server with a build signed with different keys will not work and will
+ essentially perform a denial of service attack on our update service. If you try to
+ use the official URL, the app will download an official update and will detect it as
+ corrupted or tampered. It will delete the update and try to download it over and over
+ again since it will never be signed with your key.</p>
+
+ <pre>export OFFICIAL_BUILD=true</pre>
+
<h2 id="reproducible-builds">
<a href="#reproducible-builds">Reproducible builds</a>
</h2>
@@ -351,6 +362,11 @@ git submodule update --init
different keys you need to stick to comparing everything other than the
signatures.</p>
+ <p>Set <code>OFFICIAL_BUILD=true</code> per the instructions above. Note that if you
+ do not change the URL to your own domain, you <strong>must</strong> disable the
+ Updater app before connecting the device to the internet, or you will be performing a
+ denial of service attack on our official update server.</p>
+
<h2 id="extracting-vendor-files-for-pixel-devices">
<a href="#extracting-vendor-files-for-pixel-devices">Extracting vendor files for Pixel devices</a>
</h2>