summaryrefslogtreecommitdiffstats
path: root/nixos/doc
diff options
context:
space:
mode:
authornuminit <me@numin.it>2020-11-13 19:18:52 -0700
committerMorgan Jones <me@numin.it>2021-01-03 21:27:23 -0700
commit5b91d4ab65748285ffad3e309bba2e7475c7d3db (patch)
treebd4a91d6bc1a6d7001251d39ce8893de0aeae637 /nixos/doc
parent80677f372f0089b0a1352134af56e38a7f653358 (diff)
Rework androidenv package generation
androidenv did not previously write license files, which caused certain gradle-based Android tools to fail. Restructure androidenv's list of Android packages into a single repo.json file to prevent duplication and enable us to extract the EULA texts, which we then hash with builtins.hashString to produce the license files that Android gradle tools look for. Remove includeDocs and lldbVersions, as these have been removed from the Android package repositories. Improve documentation and examples.
Diffstat (limited to 'nixos/doc')
-rw-r--r--nixos/doc/manual/release-notes/rl-2103.xml16
1 files changed, 16 insertions, 0 deletions
diff --git a/nixos/doc/manual/release-notes/rl-2103.xml b/nixos/doc/manual/release-notes/rl-2103.xml
index 432de831cb67..8cce8a7949ce 100644
--- a/nixos/doc/manual/release-notes/rl-2103.xml
+++ b/nixos/doc/manual/release-notes/rl-2103.xml
@@ -335,6 +335,22 @@ http://some.json-exporter.host:7979/probe?target=https://example.com/some/json/e
official documentation</link> of the json_exporter.
</para>
</listitem>
+ <listitem>
+ <para>
+ Androidenv was updated, removing the <literal>includeDocs</literal> and <literal>lldbVersions</literal>
+ arguments. Docs only covered a single version of the Android SDK, LLDB is now bundled with the NDK,
+ and both are no longer available to download from the Android package repositories. Additionally, since
+ the package lists have been updated, some older versions of Android packages may not be bundled. If you
+ depend on older versions of Android packages, we recommend overriding the repo.
+ </para>
+ <para>
+ Android packages are now loaded from a repo.json file created by parsing Android repo XML files. The arguments
+ <literal>repoJson</literal> and <literal>repoXmls</literal> have been added to allow overriding the built-in
+ androidenv repo.json with your own. Additionally, license files are now written to allow compatibility
+ with Gradle-based tools, and the <literal>extraLicenses</literal> argument has been added to accept more
+ SDK licenses if your project requires it. See the androidenv documentation for more details.
+ </para>
+ </listitem>
</itemizedlist>
</section>