Android AAPT工具指南

Android Asset Packaging Tool

AAPT命令格式

./appt

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
E:\Android\SDK\build-tools\24.0.1>aapt
Android Asset Packaging Tool

Usage:
aapt l[ist] [-v] [-a] file.{zip,jar,apk}
List contents of Zip-compatible archive.

aapt d[ump] [--values] [--include-meta-data] WHAT file.{apk} [asset [asset ...]]
strings Print the contents of the resource table string pool in the APK.
badging Print the label and icon for the app declared in APK.
permissions Print the permissions from the APK.
resources Print the resource table from the APK.
configurations Print the configurations in the APK.
xmltree Print the compiled xmls in the given assets.
xmlstrings Print the strings of the given compiled xml assets.

aapt p[ackage] [-d][-f][-m][-u][-v][-x][-z][-M AndroidManifest.xml] \
[-0 extension [-0 extension ...]] [-g tolerance] [-j jarfile] \
[--debug-mode] [--min-sdk-version VAL] [--target-sdk-version VAL] \
[--app-version VAL] [--app-version-name TEXT] [--custom-package VAL] \
[--rename-manifest-package PACKAGE] \
[--rename-instrumentation-target-package PACKAGE] \
[--utf16] [--auto-add-overlay] \
[--max-res-version VAL] \
[-I base-package [-I base-package ...]] \
[-A asset-source-dir] [-G class-list-file] [-P public-definitions-file] \
[-D main-dex-class-list-file] \
[-S resource-sources [-S resource-sources ...]] \
[-F apk-file] [-J R-file-dir] \
[--product product1,product2,...] \
[-c CONFIGS] [--preferred-density DENSITY] \
[--split CONFIGS [--split CONFIGS]] \
[--feature-of package [--feature-after package]] \
[raw-files-dir [raw-files-dir] ...] \
[--output-text-symbols DIR]

Package the android resources. It will read assets and resources that are
supplied with the -M -A -S or raw-files-dir arguments. The -J -P -F and -R
options control which files are output.

aapt r[emove] [-v] file.{zip,jar,apk} file1 [file2 ...]
Delete specified files from Zip-compatible archive.

aapt a[dd] [-v] file.{zip,jar,apk} file1 [file2 ...]
Add specified files to Zip-compatible archive.

aapt c[runch] [-v] -S resource-sources ... -C output-folder ...
Do PNG preprocessing on one or several resource folders
and store the results in the output folder.

aapt s[ingleCrunch] [-v] -i input-file -o outputfile
Do PNG preprocessing on a single file.

aapt v[ersion]
Print program version.

Modifiers:
-a print Android-specific data (resources, manifest) when listing
-c specify which configurations to include. The default is all
configurations. The value of the parameter should be a comma
separated list of configuration values. Locales should be specified
as either a language or language-region pair. Some examples:
en
port,en
port,land,en_US
-d one or more device assets to include, separated by commas
-f force overwrite of existing files
-g specify a pixel tolerance to force images to grayscale, default 0
-j specify a jar or zip file containing classes to include
-k junk path of file(s) added
-m make package directories under location specified by -J
-u update existing packages (add new, replace older, remove deleted files)
-v verbose output
-x create extending (non-application) resource IDs
-z require localization of resource attributes marked with
localization="suggested"
-A additional directory in which to find raw asset files
-G A file to output proguard options into.
-D A file to output proguard options for the main dex into.
-F specify the apk file to output
-I add an existing package to base include set
-J specify where to output R.java resource constant definitions
-M specify full path to AndroidManifest.xml to include in zip
-P specify where to output public resource definitions
-S directory in which to find resources. Multiple directories will be scanned
and the first match found (left to right) will take precedence.
-0 specifies an additional extension for which such files will not
be stored compressed in the .apk. An empty string means to not
compress any files at all.
--debug-mode
inserts android:debuggable="true" in to the application node of the
manifest, making the application debuggable even on production devices.
--include-meta-data
when used with "dump badging" also includes meta-data tags.
--pseudo-localize
generate resources for pseudo-locales (en-XA and ar-XB).
--min-sdk-version
inserts android:minSdkVersion in to manifest. If the version is 7 or
higher, the default encoding for resources will be in UTF-8.
--target-sdk-version
inserts android:targetSdkVersion in to manifest.
--max-res-version
ignores versioned resource directories above the given value.
--values
when used with "dump resources" also includes resource values.
--version-code
inserts android:versionCode in to manifest.
--version-name
inserts android:versionName in to manifest.
--replace-version
If --version-code and/or --version-name are specified, these
values will replace any value already in the manifest. By
default, nothing is changed if the manifest already defines
these attributes.
--custom-package
generates R.java into a different package.
--extra-packages
generate R.java for libraries. Separate libraries with ':'.
--generate-dependencies
generate dependency files in the same directories for R.java and resource package
--auto-add-overlay
Automatically add resources that are only in overlays.
--preferred-density
Specifies a preference for a particular density. Resources that do not
match this density and have variants that are a closer match are removed.
--split
Builds a separate split APK for the configurations listed. This can
be loaded alongside the base APK at runtime.
--feature-of
Builds a split APK that is a feature of the apk specified here. Resources
in the base APK can be referenced from the the feature APK.
--feature-after
An app can have multiple Feature Split APKs which must be totally ordered.
If --feature-of is specified, this flag specifies which Feature Split APK
comes before this one. The first Feature Split APK should not define
anything here.
--rename-manifest-package
Rewrite the manifest so that its package name is the package name
given here. Relative class names (for example .Foo) will be
changed to absolute names with the old package so that the code
does not need to change.
--rename-instrumentation-target-package
Rewrite the manifest so that all of its instrumentation
components target the given package. Useful when used in
conjunction with --rename-manifest-package to fix tests against
a package that has been renamed.
--product
Specifies which variant to choose for strings that have
product variants
--utf16
changes default encoding for resources to UTF-16. Only useful when API
level is set to 7 or higher where the default encoding is UTF-8.
--non-constant-id
Make the resources ID non constant. This is required to make an R java class
that does not contain the final value but is used to make reusable compiled
libraries that need to access resources.
--shared-lib
Make a shared library resource package that can be loaded by an application
at runtime to access the libraries resources. Implies --non-constant-id.
--app-as-shared-lib
Make an app resource package that also can be loaded as shared library at runtime.
Implies --non-constant-id.
--error-on-failed-insert
Forces aapt to return an error if it fails to insert values into the manifest
with --debug-mode, --min-sdk-version, --target-sdk-version --version-code
and --version-name.
Insertion typically fails if the manifest already defines the attribute.
--error-on-missing-config-entry
Forces aapt to return an error if it fails to find an entry for a configuration.
--output-text-symbols
Generates a text file containing the resource symbols of the R class in the
specified folder.
--ignore-assets
Assets to be ignored. Default pattern is:
!.svn:!.git:!.ds_store:!*.scc:.*:<dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~
--skip-symbols-without-default-localization
Prevents symbols from being generated for strings that do not have a default
localization
--no-version-vectors
Do not automatically generate versioned copies of vector XML resources.
--private-symbols
Java package name to use when generating R.java for private resources.

AAPT版本信息

1
aapt v[ersion] [<APK Path>]
1
2
E:\Android\SDK\build-tools\24.0.1>aapt v
Android Asset Packaging Tool, v0.2-3051502

修改APK包

aapt p[ackage]

aapt r[emove]

aapt a[dd]

AAPT

./aapt l[ist]

AAPT Source Code

AAPT的源代码位于 frameworks/base/tools/aapt/

包含的代码文件如下所示:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
AaptAssets.cpp	07-Jan-2016	51.4 KiB
AaptAssets.h 07-Jan-2016 19 KiB
AaptConfig.cpp 07-Jan-2016 23.2 KiB
AaptConfig.h 07-Jan-2016 3.7 KiB
AaptUtil.cpp 07-Jan-2016 1.6 KiB
AaptUtil.h 07-Jan-2016 2.1 KiB
AaptXml.cpp 07-Jan-2016 5.7 KiB
AaptXml.h 07-Jan-2016 4.4 KiB
Android.mk 07-Jan-2016 3.6 KiB
ApkBuilder.cpp 07-Jan-2016 4.4 KiB
ApkBuilder.h 07-Jan-2016 3.3 KiB
Bundle.h 07-Jan-2016 15.6 KiB
CacheUpdater.h 07-Jan-2016 3.6 KiB
Command.cpp 07-Jan-2016 122.2 KiB
ConfigDescription.h 07-Jan-2016 2.2 KiB
CrunchCache.cpp 07-Jan-2016 3.6 KiB
CrunchCache.h 07-Jan-2016 3.4 KiB
DirectoryWalker.h 07-Jan-2016 2.5 KiB
FileFinder.cpp 07-Jan-2016 2.8 KiB
FileFinder.h 07-Jan-2016 2.8 KiB
Images.cpp 07-Jan-2016 48.6 KiB
Images.h 07-Jan-2016 680
IndentPrinter.h 07-Jan-2016 1.3 KiB
Main.cpp 07-Jan-2016 30 KiB
Main.h 07-Jan-2016 1.9 KiB
NOTICE 07-Jan-2016 10.4 KiB
OutputSet.h 07-Jan-2016 1.5 KiB
Package.cpp 07-Jan-2016 14.8 KiB
pseudolocalize.cpp 07-Jan-2016 11.7 KiB
pseudolocalize.h 07-Jan-2016 1.5 KiB
Resource.cpp 07-Jan-2016 118 KiB
ResourceFilter.cpp 07-Jan-2016 3.8 KiB
ResourceFilter.h 07-Jan-2016 3.4 KiB
ResourceIdCache.cpp 07-Jan-2016 2.9 KiB
ResourceIdCache.h 07-Jan-2016 598
ResourceTable.cpp 07-Jan-2016 186.5 KiB
ResourceTable.h 07-Jan-2016 22.8 KiB
SdkConstants.h 07-Jan-2016 1.2 KiB
SourcePos.cpp 07-Jan-2016 3 KiB
SourcePos.h 07-Jan-2016 567
StringPool.cpp 07-Jan-2016 19.3 KiB
StringPool.h 07-Jan-2016 6.8 KiB
Symbol.h 07-Jan-2016 2.6 KiB
tests/ 07-Jan-2016 4 KiB
WorkQueue.cpp 07-Jan-2016 4.1 KiB
WorkQueue.h 07-Jan-2016 3.7 KiB
XMLNode.cpp 07-Jan-2016 53.1 KiB
XMLNode.h 07-Jan-2016 6.1 KiB
ZipEntry.cpp 07-Jan-2016 22.1 KiB
ZipEntry.h 07-Jan-2016 10.2 KiB
ZipFile.cpp 07-Jan-2016 36.3 KiB
ZipFile.h 07-Jan-2016 8.5 KiB