# Titanium.App.Android

> A module used to access Android application resources.

- Source: https://titaniumsdk.com/docs/sdk/12.6.2/Titanium.App.Android
- Titanium SDK version: 12.6.2
- Kind: module
- Platforms: Android
- Since: Titanium SDK 1.5
- Extends: Titanium.Module
- Inheritance: Titanium.Module > Titanium.Proxy

For more information, refer to the official documentation on the Android Developer website about 
[application resources](https://developer.android.com/guide/topics/resources/index.html).

## Example: Custom String Resource

Custom Android resources may be placed in `platform/android` in the project root.  
For example, to utilize a custom localization file, create and populate 
`platform/android/res/values/mystrings.xml` with the following data.

``` xml
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="mystring">testing 1 2 3</string>
</resources>
```

In Javascript, this can be accessed as follows.

``` js
var activity = Ti.Android.currentActivity;
var R = Ti.App.Android.R;

var mystring = activity.getString(R.string.mystring);
Ti.API.debug("mystring = " + mystring);
```

## Properties

### appVersionCode

- Type: Number
- Platforms: Android
- Since: Titanium SDK 3.3.0
- Permission: read-only

The version number of the application.

### appVersionName

- Type: String
- Platforms: Android
- Since: Titanium SDK 3.3.0
- Permission: read-only

The version name of the application.

### launchIntent

- Type: Titanium.Android.Intent
- Platforms: Android
- Since: Titanium SDK 3.3.0
- Permission: read-only

Return the intent that was used to launch the application.

This intent will not change for the lifetime of the application. Its [action](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#action)
is typically set to "android.intent.action.MAIN" when launched via the app list screen.

This launch intent can be used to resume the app while backgrounded via the
[startActivity()](https://titaniumsdk.com/docs/sdk/Titanium.Android.Activity.md#startActivity) method or via a notification.

When the app is launched via a data intent such as a URL, shortcut, notification, etc. then that intent
is provided by the [Ti.Android.rootActivity](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#rootActivity) object's
[intent](https://titaniumsdk.com/docs/sdk/Titanium.Android.Activity.md#intent) property instead. That intent will initially be set to the
launch intent, but will change when a ["newintent"](https://titaniumsdk.com/docs/sdk/Titanium.Android.Activity.md#newintent) event has been fired.
You should always read the root activity's intent instead of the launch intent for data.

### R

- Type: Titanium.Android.R
- Platforms: Android
- Permission: read-only

The `R` namespace for application resources.

The properties and sub-properties of this object relate directly to the
native application resources `R` class, and thus have the same syntax.
For more information, refer to the official documentation on the
Android Developer website about
[accessing application resources](https://developer.android.com/guide/topics/resources/accessing-resources.html).

For example, if the file `platform/android/res/drawable/icon.png`
exists in the project, it can be accessed using its resource name,
as follows.

``` js
var resid = Titanium.App.Android.R.drawable.icon;
```

To access system-wide resources, rather than application resources, use
[Titanium.Android.R](https://titaniumsdk.com/docs/sdk/Titanium.Android.R.md) instead.

## Events

### shortcutitemclick

- Platforms: Android
- Since: Titanium SDK 7.5.0

Fired when a [Titanium.UI.ShortcutItem](https://titaniumsdk.com/docs/sdk/Titanium.UI.ShortcutItem.md) is clicked.

Event properties:

- `id` (String): Identifier of the clicked shortcut item.

## Inherited members

7 members are inherited. Each is documented on the type that declares it.

- [Titanium.Proxy](https://titaniumsdk.com/docs/sdk/12.6.2/Titanium.Proxy.md): `addEventListener`, `apiName`, `applyProperties`, `bubbleParent`, `fireEvent`, `lifecycleContainer`, `removeEventListener`

---

- This corpus documents Titanium SDK 13.4.1. Anything here that does not name a version describes 13.4.1.
- Titanium is maintained by TiDev. The Appcelerator toolchain is retired: there is no `appc` CLI, no Appcelerator Studio and no hosted build service. The supported CLI is `titanium` on npm, invoked as `ti`.