@maccesar/titools 5.2.5 → 5.4.0

package/skills/ti-guides/references/tiapp-config.md

@@ -1,670 +1,294 @@
-# tiapp.xml and timodule.xml configuration
+# tiapp.xml
 
-Reference for Titanium app configuration files. `tiapp.xml` is the main config file for Titanium apps. `timodule.xml` is for custom modules.
 
-<!-- TOC-START -->
-## Contents
+Every element the build reads, verified against Titanium SDK 13.4.1. For what
+`tiapp.xml` is and where it sits, see
+[project structure](https://titaniumsdk.com/docs/build/project-structure).
 
-- [tiapp.xml structure](#tiappxml-structure)
-- [Top-level elements](#top-level-elements)
-- [Application properties](#application-properties)
-- [Android section](#android-section)
-- [iOS section](#ios-section)
-- [Google Play Services](#google-play-services)
-- [timodule.xml (module configuration)](#timodulexml-module-configuration)
-- [SDK version precedence](#sdk-version-precedence)
-- [References](#references)
+Edit it in a text editor, or from a script with `ti project`. Elements are
+children of the root `<ti:app>` unless the table says otherwise.
 
-<!-- TOC-END -->
+> [!IMPORTANT]
+> An element the SDK does not recognise is not an error. A misspelled top-level
+> element is parsed and then never read; a misspelled child of `<ios>` or
+> `<android>` is discarded outright. Either way the build succeeds and your
+> setting does nothing, so check the spelling here before assuming a bug.
 
-## tiapp.xml structure
+## Identity
 
 ```xml
-<ti:app xmlns:ti="http://ti.tidev.io">
-  <id>com.titaniumsdk.helloWorld</id>
-  <name>helloWorld</name>
-  <version>1.0.1</version>
+<ti:app xmlns:ti="http://ti.titaniumsdk.com">
+  <id>com.example.hello</id>
+  <name>Hello</name>
+  <version>1.0</version>
+  <guid>f0391a5d-2689-47cf-a6aa-df0f849fbe50</guid>
   <icon>appicon.png</icon>
-  <fullscreen>false</fullscreen>
-  <navbar-hidden>false</navbar-hidden>
-  <analytics>false</analytics>
-  <guid>GUID</guid>
-  <ios>
-    <plist>
-      <dict>
-        <key>UISupportedInterfaceOrientations~iphone</key>
-        <array>
-          <string>UIInterfaceOrientationPortrait</string>
-        </array>
-        <key>UISupportedInterfaceOrientations~ipad</key>
-        <array>
-          <string>UIInterfaceOrientationPortrait</string>
-          <string>UIInterfaceOrientationPortraitUpsideDown</string>
-          <string>UIInterfaceOrientationLandscapeLeft</string>
-          <string>UIInterfaceOrientationLandscapeRight</string>
-        </array>
-      </dict>
-    </plist>
-  </ios>
-  <android xmlns:android="http://schemas.android.com/apk/res/android">
-    <tool-api-level>10</tool-api-level>
-    <abi>all</abi>
-  </android>
-  <modules/>
 </ti:app>
 ```
 
-tiapp.xml properties are encrypted when building for production.
-
----
-
-## Top-level elements
-
-### Required elements
-
-#### `<guid>`
-
-Required. Unique ID generated by the CLI. Do not modify unless you know why.
-
-#### `<id>`
-
-Required. Application ID.
-
-- Android: package ID following Java package naming standards
-- iOS: must match Bundle ID from Apple Developer Portal
-
-```xml
-<id>com.mycompany.fakeblock</id>
-```
-
-#### `<name>`
-
-Required. Application name shown under the icon on device.
-
-```xml
-<name>Fakeblock</name>
-```
-
-Android warning: if the name starts with a digit, prefix the activity name with an underscore (for example, `_2Foo`).
-
-### Optional elements
-
-#### `<defaultLang>`
-
-Sets the default language for Android i18n `strings.xml`. Android defaults to `en`. If you only use a single non-English i18n file, set this to that language.
-
-```xml
-<defaultLang>de</defaultLang>
-```
-
-#### `<copyright>`
-
-Application copyright.
-
-#### `<description>`
-
-Application description.
-
-```xml
-<description>Tap to rock out with this block.</description>
-```
-
-#### `<fullscreen>`
-
-Start the app in fullscreen (hides the status bar).
+| Element   | Value               | What it controls                                                  |
+| --------- | ------------------- | ----------------------------------------------------------------- |
+| `id`      | reverse-DNS string  | Android package name and iOS bundle identifier. Required          |
+| `name`    | string              | The name under the icon. Required                                 |
+| `version` | `1`, `1.0`, `1.0.0` | The version shown in the stores. Defaults to `1.0`                |
+| `guid`    | UUID                | Generated per project. Required, and rejected if it is not a UUID |
+| `icon`    | filename            | Must end in `.png`. Falls back to `appicon.png`                   |
 
-```xml
-<fullscreen>false</fullscreen>  <!-- default -->
-```
+`version` has to start with a whole number greater than zero, so `0.9` is
+rejected and `1.0.0.beta1` is accepted. Set the property
+`ti.skipVersionValidation` to bypass that check, and `ti.skipAppIdValidation`
+to bypass the app id one.
 
-#### `<icon>`
+> [!IMPORTANT]
+> Changing `id` after publishing means a **new listing** in both stores rather
+> than an update. Set it to a domain you control when you create the project.
 
-Icon filename relative to `Resources/` or a platform-specific folder.
+`guid` identifies the project, so copying a `tiapp.xml` from another app carries
+its guid along. Change it when you do that.
 
-```xml
-<icon>appicon.png</icon>
-```
+`publisher`, `url`, `description` and `copyright` are also accepted. Nothing
+reads them: no build uses them and neither store shows them. `ti create` writes
+`not specified` into all four.
 
-#### `<navbar-hidden>`
-
-Hide the navigation bar.
+## What gets built
 
 ```xml
-<navbar-hidden>false</navbar-hidden>  <!-- default -->
-```
-
-Android: removes the top action/title bar.
-
-#### `<publisher>`
-
-Application publisher.
-
-```xml
-<publisher>Bluth Company</publisher>
+<sdk-version>13.4.1.GA</sdk-version>
+<deployment-targets>
+  <target device="android">true</target>
+  <target device="iphone">true</target>
+  <target device="ipad">false</target>
+</deployment-targets>
 ```
 
-#### `<statusbar-hidden>`
+`sdk-version` pins which installed SDK builds the project, and `--sdk` overrides
+it for one build. A project without it uses the newest installed SDK, which
+means two machines can build the same commit differently.
 
-Android only. Hide the status bar.
+`deployment-targets` is which platforms and device families are built. The
+`device` values are `android`, `iphone` and `ipad`; turning `ipad` off is what
+`--platforms iphone` does at creation. On iOS the two Apple entries decide the
+device family the app declares.
 
-```xml
-<statusbar-hidden>false</statusbar-hidden>  <!-- default -->
-```
+## Application settings
 
-#### `<url>`
+Top-level switches. Each says which platform reads it, because most of them are
+read by one platform and silently ignored by the other.
 
-Application URL.
+| Element                | Value  | Platform | Effect                                                        |
+| ---------------------- | ------ | -------- | ------------------------------------------------------------- |
+| `fullscreen`           | bool   | Android  | Hides the status bar, through the generated theme             |
+| `navbar-hidden`        | bool   | Android  | Hides the title bar                                           |
+| `override-permissions` | bool   | Android  | Stops the build adding permissions it inferred from your code |
+| `defaultLang`          | string | Android  | Which i18n locale becomes the unsuffixed resource directory   |
+| `statusbar-hidden`     | bool   | both     | `UIStatusBarHidden` on iOS; hides the status bar on Android   |
+| `statusbar-style`      | string | iOS      | `UIStatusBarStyle`. See below                                 |
+| `persistent-wifi`      | bool   | iOS      | `UIRequiresPersistentWiFi`                                    |
+| `prerendered-icon`     | bool   | iOS      | `UIPrerenderedIcon`                                           |
+| `transpile`            | bool   | both     | Transpiles your JavaScript. **On unless set to `false`**      |
+| `source-maps`          | bool   | both     | Emits source maps. `--source-maps` overrides it               |
 
-```xml
-<url>http://www.bluthcompany.com/fakeblock</url>
-```
+`statusbar-style` is matched loosely: `opaque_black`, `opaque` or `black` give
+`UIStatusBarStyleBlackOpaque`, and `translucent_black`, `transparent` or
+`translucent` give `UIStatusBarStyleBlackTranslucent`. Anything else, including
+a typo, gives the default style.
 
-#### `<version>`
+The element is `source-maps`. `sourcemaps` without the hyphen is one of the
+unrecognised elements above: accepted, and then ignored.
 
-Application version.
+## Runtime properties
 
 ```xml
-<version>3.1.4</version>
+<property name="ti.ui.defaultunit" type="string">dp</property>
+<property name="apiRoot" type="string">https://example.com/api</property>
+<property name="cacheSeconds" type="int">300</property>
 ```
 
-iOS: truncated to 3 dot-separated numbers (for example, `2.1.0.1` becomes `2.1.0`).
+Everything here is written into the app and readable at runtime through
+`Ti.App.Properties`. `name` is required; a `<property>` without one is ignored.
 
-#### `<sdk-version>`
+| `type`   | Parsed as                    |
+| -------- | ---------------------------- |
+| `bool`   | `true` only for `true`       |
+| `int`    | Whole number, `0` on failure |
+| `double` | Decimal, `0` on failure      |
+| omitted  | String                       |
 
-Titanium SDK to build against.
-
-```xml
-<sdk-version>11.1.0.GA</sdk-version>
-```
+Any other `type` is treated as a string, so `type="boolean"` silently gives you
+the string `"true"` rather than a boolean. Reading a property with a getter that
+does not match its type returns the default instead of converting.
 
-#### `<deployment-targets>`
+Properties the SDK itself reads:
 
-IDE deployment menu options.
+| Property                    | What it does                                                  |
+| --------------------------- | ------------------------------------------------------------- |
+| `ti.ui.defaultunit`         | What a bare number means in a layout. `ti create` writes `dp` |
+| `ti.skipAppIdValidation`    | Skips the app id format check                                 |
+| `ti.skipVersionValidation`  | Skips the `version` format check                              |
+| `ti.facebook.appid`         | Wires the Facebook URL scheme into `Info.plist`               |
+| `ti.android.debug`          | Debug logging in the Android runtime. Off unless `true`       |
+| `ti.android.loadfromsdcard` | Loads JavaScript off the SD card, for development             |
+| `android.javac.maxMemory`   | Heap for the Java compiler, when a large project runs out     |
 
-```xml
-<deployment-targets>
-    <target device="android">true</target>
-    <target device="ipad">false</target>
-    <target device="iphone">false</target>
-</deployment-targets>
-```
+`ti.ui.defaultunit` accepts `system`, `px`, `dp`, `dip`, `mm`, `cm` and `in`,
+and defaults to `system`.
 
-#### `<modules>`
+> [!NOTE]
+> `run-on-main-thread` is in the default template and does nothing. It has been
+> ignored since 8.0.0, when running on the main thread became the only
+> behaviour. Deleting it changes nothing either.
 
-Include Titanium modules.
+## Modules and plugins
 
 ```xml
 <modules>
-    <module>ti.map</module>
-    <module platform="android">ti.map</module>
-    <module platform="ios">ti.map</module>
-    <module version="2.0.0">ti.alloy</module>
-    <module deploy-type="production">ti.analytics</module>
+  <module platform="android" version="5.7.0">ti.map</module>
+  <module platform="iphone">ti.map</module>
 </modules>
-```
-
-Attributes:
-- `platform`: `android`, `commonjs`, `iphone`
-- `version`: specific module version
-- `deploy-type`: `development`, `test`, `production` (comma-separated)
-
-#### `<plugins>`
 
-Include plugins (in the `plugins/` folder).
-
-```xml
 <plugins>
-    <plugin version="1.0">ti.alloy</plugin>
+  <plugin version="1.0">ti.alloy</plugin>
 </plugins>
 ```
 
----
-
-## Application properties
-
-Custom properties accessible via `Titanium.App.Properties`. Read-only in production.
-
-```xml
-<property name="name" type="type">value</property>
-```
-
-Types: `string`, `bool`, `int`, `double`
-
-### Special properties
-
-#### `ti.ui.defaultunit`
-
-Default unit for sizes/positions.
-
-```xml
-<property name="ti.ui.defaultunit">system</property>
-```
-
-Values: `system`, `cm`, `dip`/`dp`, `in`, `mm`, `px`
-
-#### `run-on-main-thread`
-
-Since 5.1.0. Run all JavaScript on the main thread instead of a secondary thread. Disabled by default in existing projects, enabled in new projects. Enabled automatically in SDK 7.0.0+.
-
-```xml
-<property name="run-on-main-thread" type="bool">true</property>
-```
-
-#### `allow-custom-keyboards`
-
-Since 6.1.0. Allow or disallow custom iOS 8+ keyboard extensions. Custom keyboards are allowed by default. Set to `false` to disallow them.
-
-```xml
-<property name="allow-custom-keyboards" type="bool">false</property>
-```
-
----
-
-## Android section
+A module on disk that is not listed here is not built in, and the failure is a
+`require` returning nothing. `platform` and `version` are both optional; without
+a version the newest installed is used. See [using modules](https://titaniumsdk.com/docs/build/modules).
+
+`ti.alloy` in `plugins` is what makes a project an Alloy project, and
+`alloy new` adds it. A plugin listed here that is not installed fails the build
+rather than being skipped.
+
+## iOS
+
+Children of `<ios>`. Anything else inside `<ios>` is discarded without a
+warning.
+
+| Element                           | Value     | Effect                                                                    |
+| --------------------------------- | --------- | ------------------------------------------------------------------------- |
+| `plist`                           | dict      | Merged over `Info.plist`, last. See below                                 |
+| `entitlements`                    | dict      | Merged into `Entitlements.plist`                                          |
+| `capabilities`                    | element   | Only `<app-groups>` is understood, giving app group entitlements          |
+| `extensions`                      | element   | App extensions to build alongside the app                                 |
+| `min-ios-ver`                     | `15.0`    | Raises the deployment target. **Only honored above the SDK's own floor**  |
+| `team-id`                         | string    | Apple Developer team, when your account has more than one                 |
+| `default-background-color`        | `#rrggbb` | Background of the generated launch storyboard                             |
+| `use-app-thinning`                | bool      | App thinning and asset catalogs. Off unless set to `true`                 |
+| `use-jscore-framework`            | bool      | Apple's JavaScriptCore instead of the bundled one. **On unless `false`**  |
+| `use-autolayout`                  | bool      | Auto Layout. Off unless set to `true`                                     |
+| `use-new-build-system`            | bool      | Xcode's new build system. On for Xcode 10 and later                       |
+| `enable-launch-screen-storyboard` | bool      | Generates a launch storyboard instead of launch images                    |
+| `exclude-dir-from-asset-catalog`  | bool      | Keeps a directory of images out of the asset catalog                      |
+| `log-server-port`                 | int       | Port for the log server, 1024 to 65535. Derived from the app id otherwise |
+
+The SDK's own iOS floor is 15.0 in 13.4.1, so a `min-ios-ver` below that is
+ignored rather than applied. The floor per release is on
+[compatibility](https://titaniumsdk.com/docs/reference/compatibility).
+
+`<plist>` takes `Info.plist` keys verbatim, which is where permission strings
+and orientations go:
+
+```xml
+<ios>
+  <enable-launch-screen-storyboard>true</enable-launch-screen-storyboard>
+  <plist>
+    <dict>
+      <key>NSCameraUsageDescription</key>
+      <string>Attach a photo to a note.</string>
+      <key>UISupportedInterfaceOrientations~iphone</key>
+      <array>
+        <string>UIInterfaceOrientationPortrait</string>
+      </array>
+    </dict>
+  </plist>
+</ios>
+```
+
+A missing usage string is an App Store rejection and, before that, a permission
+dialog that never appears. See [media](https://titaniumsdk.com/docs/build/media).
+
+Keys the build owns are stripped from `<plist>` before the merge:
+`CFBundleDisplayName`, `CFBundleExecutable`, `CFBundleIconFile`,
+`CFBundleIdentifier`, `CFBundleInfoDictionaryVersion`, `CFBundleName`,
+`CFBundlePackageType`, `CFBundleSignature` and `LSRequiresIPhoneOS`. Setting one
+of those here does nothing; set `<id>` and `<name>` instead.
+
+## Android
+
+Children of `<android>`. As with `<ios>`, anything else is discarded. The
+`xmlns:android` declaration belongs on the `<android>` element.
+
+| Element          | Value           | Effect                                                              |
+| ---------------- | --------------- | ------------------------------------------------------------------- |
+| `manifest`       | XML             | Merged into the generated `AndroidManifest.xml`                     |
+| `tool-api-level` | int             | The API level the app is compiled against                           |
+| `abi`            | comma-separated | Which ABIs to package. `all` packages every one                     |
+| `activities`     | element         | Extra activities, each keyed by the JavaScript file it opens        |
+| `services`       | element         | Extra services. `type="quicksettings"` builds a quick settings tile |
 
 ```xml
 <android xmlns:android="http://schemas.android.com/apk/res/android">
-  <abi>all</abi>
-  <activities>
-    <activity url="activity.js"/>
-  </activities>
-  <services>
-    <service url="service.js" type="standard"/>
-  </services>
-  <manifest>
-    <uses-sdk android:minSdkVersion="10" android:targetSdkVersion="14"/>
-    <application>
-        <activity>...</activity>
-        <service>...</service>
-    </application>
+  <manifest android:versionCode="1">
+    <uses-permission android:name="android.permission.CAMERA"/>
+    <application android:icon="@mipmap/ic_launcher"/>
   </manifest>
+  <abi>arm64-v8a,x86_64</abi>
 </android>
 ```
 
-### Elements
+`android:versionCode` is the integer Google Play orders releases by, and it has
+to increase on every upload. `<version>` above is the human one; these are
+separate numbers and both matter.
 
-#### `<abi>`
+Restricting `abi` shrinks the APK and is the usual reason to set it. An ABI you
+drop is a device the app will not install on.
 
-Target ABI architecture (V8 runtime only).
+## Elements that no longer work
 
-```xml
-<abi>all</abi>  <!-- default -->
-```
+| Element            | State                                                                    |
+| ------------------ | ------------------------------------------------------------------------ |
+| `<iphone>`         | **Removed in 7.0.0.** The iOS build stops with an error if it is present |
+| `<code-processor>` | Parsed and never read. Nothing in the SDK acts on it                     |
+| `<webpack>`        | Parsed and never read by the SDK                                         |
 
-Values: `all`, `arm64-v8a`, `armeabi-v7a`, `x86`, `x86_64`
+`<iphone>` is the only one that fails a build. Move its contents into `<ios>`.
 
-Targeting specific ABIs reduces APK size but also reduces device compatibility.
+## timodule.xml
 
-#### `<activities>`
+A native or CommonJS module carries `timodule.xml` instead of `tiapp.xml`, and
+the SDK parses it with the same code, so it accepts the same vocabulary. It does
+not act on the same vocabulary: an app building a module reads exactly two
+things out of it.
 
-Custom JavaScript-based Android activities.
+| Element               | Effect on the app that includes the module             |
+| --------------------- | ------------------------------------------------------ |
+| `<modules>`           | Modules this module needs, added to the app's own list |
+| `<android><manifest>` | Merged into the app's `AndroidManifest.xml`            |
 
-```xml
-<activities>
-    <activity url="activity.js">
-        <!-- Android Manifest elements -->
-    </activity>
-</activities>
-```
-
-#### `<services>`
-
-Custom JavaScript-based Android services (background processes).
+Both are Android only. The iOS build reads nothing from `timodule.xml`: an iOS
+module's `Info.plist` and entitlements come from its own files.
 
 ```xml
-<services>
-    <service url="service.js" type="standard"/>
-</services>
-```
-
-#### `<manifest>`
-
-Ad-hoc AndroidManifest.xml elements.
-
-Set target/minimum SDK:
-```xml
-<android xmlns:android="http://schemas.android.com/apk/res/android">
+<ti:app xmlns:ti="http://ti.titaniumsdk.com">
+  <modules>
+    <module platform="android">ti.playservices</module>
+  </modules>
+  <android xmlns:android="http://schemas.android.com/apk/res/android">
     <manifest>
-        <!-- Target Android 10.0, min Android 5.0 -->
-        <uses-sdk android:minSdkVersion="21" android:targetSdkVersion="29"/>
+      <uses-permission android:name="android.permission.VIBRATE"/>
     </manifest>
-</android>
-```
-
-Screen density support:
-```xml
-<manifest>
-    <supports-screens
-        android:smallScreens="true"
-        android:normalScreens="true"
-        android:largeScreens="true"
-        android:xlargeScreens="true"
-    />
-</manifest>
-```
-
-Do not set `android:anyDensity="false"`.
-
-Enable debugging:
-```xml
-<manifest>
-    <application android:debuggable="true" />
-</manifest>
-```
-
-Install location:
-```xml
-<manifest android:installLocation="preferExternal">
-    <uses-sdk android:minSdkVersion="7" />
-</manifest>
-```
-
-Values: `preferExternal`, `auto`, `internalOnly`
-
-Request large heap:
-```xml
-<manifest>
-    <application android:largeHeap="true"/>
-</manifest>
-```
-
-### Android-specific properties
-
-| Property                               | Type   | Default | Description                                |
-| -------------------------------------- | ------ | ------- | ------------------------------------------ |
-| `ti.android.shake.factor`              | double | 1.3     | Shake event sensitivity                    |
-| `ti.android.shake.quiet.milliseconds`  | int    | 500     | Quiet time before shake event              |
-| `ti.android.shake.active.milliseconds` | int    | 1000    | Active time for shake event                |
-| `ti.android.httpclient.maxbuffersize`  | int    | 524288  | HTTP response buffer size (bytes)          |
-| `ti.android.compilejs`                 | bool   | -       | Enable JS compilation (default: dist only) |
-| `ti.android.debug`                     | bool   | false   | Enable detailed logging                    |
-
-```xml
-<property name="ti.android.fastdev">false</property>
-```
-
----
-
-## iOS section
-
-```xml
-<ti:app>
-  <ios>
-    <team-id>YOUR_TEAM_ID</team-id>
-    <entitlements>
-      <dict>
-        <key>com.apple.security.application-groups</key>
-        <array>
-          <string>group.com.titaniumsdk.mycoolapp</string>
-        </array>
-      </dict>
-    </entitlements>
-    <extensions>
-      ...
-    </extensions>
-    <plist>
-      <dict>
-        <!-- Info.plist entries -->
-      </dict>
-    </plist>
-    <use-autolayout>true</use-autolayout>
-    <min-ios-ver>9.0</min-ios-ver>
-  </ios>
+  </android>
 </ti:app>
 ```
 
-### Elements
-
-#### `<team-id>`
-
-Since 5.0.0. Required for app extensions (share, watch, Siri).
-
-```xml
-<team-id>YOUR_TEAM_ID</team-id>
-```
-
-#### `<entitlements>`
-
-Since 6.1.0. Target entitlements (merged with internal entitlements).
-
-```xml
-<entitlements>
-  <dict>
-    <key>com.apple.security.application-groups</key>
-    <array>
-      <string>group.com.titaniumsdk.mycoolapp</string>
-    </array>
-  </dict>
-</entitlements>
-```
-
-#### `<extensions>`
-
-Since 5.0.0. iOS extensions.
-
-```xml
-<extensions>
-  <extension projectPath="extensions/foo/foo.xcodeproj">
-    <target name="foo WatchApp Extension">
-      <provisioning-profiles>
-        <devices/>
-        <dist-appstore/>
-        <dist-adhoc/>
-      </provisioning-profiles>
-    </target>
-  </extension>
-</extensions>
-```
-
-#### `<min-ios-ver>`
-
-Minimum iOS version.
-
-```xml
-<min-ios-ver>9.0</min-ios-ver>  <!-- default -->
-```
-
-#### `<min-sdk-ver>`
-
-Minimum Xcode version.
-
-```xml
-<min-sdk-ver>9.0</min-sdk-ver>  <!-- default -->
-```
-
-#### `<plist>`
-
-Settings for generated `Info.plist`. Uses key/value pairs.
-
-Orientations:
-```xml
-<plist>
-<dict>
-  <key>UISupportedInterfaceOrientations~iphone</key>
-  <array>
-    <string>UIInterfaceOrientationPortrait</string>
-  </array>
-  <key>UISupportedInterfaceOrientations~ipad</key>
-  <array>
-    <string>UIInterfaceOrientationPortrait</string>
-    <string>UIInterfaceOrientationPortraitUpsideDown</string>
-    <string>UIInterfaceOrientationLandscapeLeft</string>
-    <string>UIInterfaceOrientationLandscapeRight</string>
-  </array>
-</dict>
-</plist>
-```
-
-Background modes:
-```xml
-<plist>
-<dict>
-  <key>UIBackgroundModes</key>
-  <array>
-    <string>audio</string>
-    <string>location</string>
-    <string>voip</string>
-    <string>newsstand-content</string>
-    <string>external-accessory</string>
-    <string>bluetooth-central</string>
-    <string>bluetooth-peripheral</string>
-  </array>
-</dict>
-</plist>
-```
-
-Device capabilities:
-```xml
-<plist>
-<dict>
-  <key>UIRequiredDeviceCapabilities</key>
-  <array>
-    <string>telephony</string>
-    <string>wifi</string>
-    <string>sms</string>
-    <string>still-camera</string>
-    <string>auto-focus-camera</string>
-    <string>front-facing-camera</string>
-    <string>camera-flash</string>
-    <string>video-camera</string>
-    <string>accelerometer</string>
-    <string>gyroscope</string>
-    <string>location-services</string>
-    <string>gps</string>
-    <string>magnetometer</string>
-    <string>gamekit</string>
-    <string>microphone</string>
-    <string>opengles-1</string>
-    <string>opengles-2</string>
-    <string>armv6</string>
-    <string>armv7</string>
-    <string>peer-peer</string>
-    <string>bluetooth-le</string>
-  </array>
-</dict>
-</plist>
-```
-
-Persistent WiFi:
-```xml
-<key>UIRequiresPersistentWiFi</key><true/>
-```
-
-Status bar style:
-```xml
-<key>UIStatusBarStyle</key><string>UIStatusBarStyleBlackTranslucent</string>
-```
-
-iOS 9 URL schemes:
-```xml
-<key>LSApplicationQueriesSchemes</key>
-<array>
-    <string>fbapi</string>
-    <string>fbauth2</string>
-    <string>twitter</string>
-    <string>whatsapp</string>
-    <string>instagram</string>
-    <string>comgooglemaps</string>
-</array>
-```
-
-#### `<use-app-thinning>`
-
-Since 5.1.0. Enable App Thinning with Asset Catalog.
-
-```xml
-<use-app-thinning>true</use-app-thinning>
-```
-
-Use `Ti.Filesystem.getAsset()` to read images from Asset Catalog.
-
-#### `<use-autolayout>`
-
-Since 5.1.0. Enable iOS auto-layout engine.
-
-```xml
-<use-autolayout>true</use-autolayout>
-```
-
-#### `<log-server-port>`
-
-Since 6.0.0. Custom log server port.
-
-```xml
-<log-server-port>27973</log-server-port>
-```
-
-### Unsupported Info.plist keys
-
-These are auto-generated by Titanium and cannot be overridden:
-- `CFBundleDisplayName`
-- `CFBundleExecutable`
-- `CFBundleIconFile`
-- `CFBundleIconFiles`
-- `CFBundleIdentifier`
-- `CFBundleInfoDictionaryVersion`
-- `CFBundleName`
-- `CFBundlePackageType`
-- `CFBundleSignature`
-- `CFBundleVersion` (pre-4.1.0)
-- `CFBundleShortVersionString` (pre-4.1.0)
-
----
-
-## Google Play Services
-
-Since 9.0.0. Automatic validation of Google Play Services. Disable if needed:
-
-```xml
-<property name="ti.playservices.validate.on.startup" type="bool">false</property>
-```
-
----
-
-## timodule.xml (module configuration)
-
-Used in custom Titanium modules. Follows the same structure as `tiapp.xml` but only contains platform-specific config (mainly Android).
-
-Supports token substitution for app-specific values:
-
-```xml
-<!-- timodule.xml -->
-<android xmlns:android="http://schemas.android.com/apk/res/android">
-  <manifest>
-    <permission android:name="${tiapp.properties['id']}.permission.MY_NEW_PERMISSION"
-    android:protectionLevel="signature" />
-  </manifest>
-</android>
-```
-
-Becomes (for app with ID `com.example.app`):
-
-```xml
-<permission android:name="com.example.app.permission.MY_NEW_PERMISSION"
-android:protectionLevel="signature" />
-```
-
-Access properties:
-- `${tiapp.properties['id']}`: app ID
-- `${tiapp.properties['name']}`: app name
-- `${tiapp.properties['version']}`: app version
-- `${tiapp.properties['publisher']}`: publisher
-
----
-
-## SDK version precedence
-
-The CLI checks SDK version in this order:
-
-1. `tiapp.xml` `<sdk-version>` tag
-2. `--sdk` CLI option
-3. `app.sdk` config setting (`ti config app.sdk <version>`)
-4. Selected SDK (`ti sdk select`)
+Anything else you put in a `timodule.xml` is accepted by the parser and acted on
+by nothing, so a module cannot set an app's `<property>` or its `<ios>` settings.
+A module's own identity comes from its `manifest` file, not from here.
 
----
+It is covered on this page rather than its own because two elements are not a
+page, and both of them are the elements documented above behaving the same way
+in a different file. See [native modules](https://titaniumsdk.com/docs/extend/modules) for writing one.
 
-## References
+## Verification boundaries
 
-- Android Manifest docs: http://developer.android.com/guide/topics/manifest/manifest-intro.html
-- iOS Info.plist Key Reference: http://developer.apple.com/library/ios/#documentation/general/Reference/InfoPlistKeyReference/Articles/iPhoneOSKeys.html
-- Java package naming: http://download.oracle.com/javase/tutorial/java/package/namingpkgs.html
+Use the selected SDK's parser/compiler to verify a setting when a current guide and observed behavior disagree. Source-code encryption is not secure credential storage. On SDK 13.4.1 the `ti.crypt` encryption selector shown elsewhere on the website is not supported by the builders; use the released configuration, and defer SDK 14 changes until GA.