Improve property comments for docs
Improve the comments associated with properties to work better with
Blueprint's auto-documenting feature.
Make all properties structs into named types so that thet types can be
found using reflection and cross-referenced to the source code to
auto-extract docs.
Remove the leading <property>: text from properties, the documentation
will include the lowercased name of the property.
Add filter tags to the nested arch properties.
Change-Id: I4ef5db86358886fe61456c24eb2dbe6f7b876115
diff --git a/java/app.go b/java/app.go
index 5f153cf..e6851b5 100644
--- a/java/app.go
+++ b/java/app.go
@@ -31,35 +31,37 @@
// AndroidManifest.xml merging
// package splits
+type androidAppProperties struct {
+ // path to a certificate, or the name of a certificate in the default
+ // certificate directory, or blank to use the default product certificate
+ Certificate string
+
+ // paths to extra certificates to sign the apk with
+ Additional_certificates []string
+
+ // If set, create package-export.apk, which other packages can
+ // use to get PRODUCT-agnostic resource data like IDs and type definitions.
+ Export_package_resources bool
+
+ // flags passed to aapt when creating the apk
+ Aaptflags []string
+
+ // list of resource labels to generate individual resource packages
+ Package_splits []string
+
+ // list of directories relative to the Blueprints file containing assets.
+ // Defaults to "assets"
+ Asset_dirs []string
+
+ // list of directories relative to the Blueprints file containing
+ // Java resources
+ Android_resource_dirs []string
+}
+
type AndroidApp struct {
javaBase
- appProperties struct {
- // certificate: path to a certificate, or the name of a certificate in the default
- // certificate directory, or blank to use the default product certificate
- Certificate string
-
- // additional_certificates: paths to extra certificates to sign the apk with
- Additional_certificates []string
-
- // export_package_resources: If set, create package-export.apk, which other packages can
- // use to get PRODUCT-agnostic resource data like IDs and type definitions.
- Export_package_resources bool
-
- // aaptflags: flags passed to aapt when creating the apk
- Aaptflags []string
-
- // package_splits: list of resource labels to generate individual resource packages
- Package_splits []string
-
- // asset_dirs: list of directories relative to the Blueprints file containing assets.
- // Defaults to "assets"
- Asset_dirs []string
-
- // android_resource_dirs: list of directories relative to the Blueprints file containing
- // Java resources
- Android_resource_dirs []string
- }
+ appProperties androidAppProperties
aaptJavaFileList string
exportPackage string