p96705831
/
platform_build
forked from openkylin/platform_build
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Document unbundle build behavior 

Test: nothing
Bug: 160390776
Change-Id: I7da365a364d9dfa81a42b04615af34dd61444577
This commit is contained in:
Jeongik Cha 2020-07-08 18:01:22 +09:00
parent bf0c1b7b77
commit 1caa24f82a
1 changed files with 27 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
core/build-system.html
View File

@ -440,6 +440,33 @@ $(GEN): $(intermediates)/<font color=red>%.lut.h</font> : $(LOCAL_PATH)/<font co
LOCAL_GENERATED_SOURCES += $(GEN)
</pre>
<h3><a name="unbundled-build"/>Unbundled build</h3>
<p>Unbundled build has several meanings by the context.
Let me explain the meaning by the flags related to "unbundled build"</p>
<h4>TARGET_BUILD_UNBUNDLED</h4>
<p>The source tree might not have the full platform sources. It is always set if
<code>TARGET_BUILD_APPS</code> or <code>TARGET_BUILD_UNBUNDLED_IMAGE</code> is set.</p>
<h4>TARGET_BUILD_USE_PREBUILT_SDKS</h4>
<p>It is an internal flag. If it is set, prebuilt SDKs are used, even if a module's
<code>LOCAL_SDK_VERSION</code> is <code>current</code> (including <code>system_current</code>,
<code>core_current</code>, and so on). If it is unset, build current SDKs,
and use them as usual.</p>
<h4>DISABLE_PREOPT</h4>
<p>It is an internal flag as well. If it is set, dexpreopt is disabled.
It is always set if <code>TARGET_BUILD_APPS</code> or <code>TARGET_BUILD_UNBUNDLED_IMAGE</code> is set,
because dexpreopt tightly depends on the platform.</p>
<h4>TARGET_BUILD_APPS</h4>
<p>Build the apps that can be distributed outside the platform, so it turns on
<code>TARGET_BUILD_UNBUNDLED</code> and <code>DISABLE_PREOPT</code>.
Also, it turns on <code>TARGET_BUILD_USE_PREBUILT_SDKS</code>, unless
<code>UNBUNDLED_BUILD_SDKS_FROM_SOURCE</code> is set.</p>
<h4>TARGET_BUILD_UNBUNDLED_IMAGE</h4>
<p>It is similar to <code>TARGET_BUILD_APPS</code>, but its target is an unbundled partition
(such as the vendor partition). Accordingly, it sets <code>TARGET_BUILD_UNBUNDLED</code> and <code>DISABLE_PREOPT</code>.
We can call the partition unbundled, because the partition can be distributed outside the platform.
And also, it turns on <code>TARGET_BUILD_USE_PREBUILT_SDKS</code>, unless
<code>UNBUNDLED_BUILD_SDKS_FROM_SOURCE</code> is set.</p>
<h3><a name="platform-specific"/>Platform specific conditionals</h3>
<p>Sometimes you need to set flags specifically for different platforms. Here
is a list of which values the different build-system defined variables will be