Configuración de Android

AIR establece varias entrada de manifiesto en el documento de manifiesto de Android generado para garantizar que las funciones del motor de ejecución y la aplicación funcionan correctamente. No se pueden definir las siguientes opciones:

El modelo de seguridad de Android requiere que cada aplicación solicite permiso para poder utilizar las funciones que tienen implicaciones de seguridad o privacidad. Estos permisos se deben especificar cuando la aplicación se empaqueta y no se pueden modificar en tiempo de ejecución. El sistema operativo Android informa al usuario sobre qué permisos solicita la aplicación cuando el usuario la instala. Si un permiso necesario para una función no se solicita, puede que el sistema operativo Android genere una excepción cuando la aplicación acceda a la función, pero la excepción no está garantizada. Las excepciones se transmiten a la aplicación mediante el motor de ejecución. En el caso de un error silencioso, se añade un mensaje de error de permiso al registro del sistema de Android.

En AIR, los permisos de Android se especifican en el elemento android del descriptor de la aplicación. El siguiente formato se utiliza para añadir permisos (PERMISSION_NAME es el nombre de un permiso de Android):

<android> 
                            <manifestAdditions> 
                            <![CDATA[ 
                            <manifest> 
                            <uses-permission android:name="android.permission.PERMISSION_NAME" /> 
                            </manifest> 
                            ]]> 
                            </manifestAdditions> 
                            </android>

Las sentencias uses-permissions del elemento manifest se añaden directamente al documento manifiesto de Android.

Los siguientes permisos son necesarios para utilizar diversas funciones de AIR:

ACCESS_COARSE_LOCATION

Permite que la aplicación acceda a datos de ubicación de red WIFI y móvil a través de la clase Geolocation.

ACCESS_FINE_LOCATION

Permite que la aplicación acceda a datos GPS a través de la clase Geolocation.

ACCESS_NETWORK_STATE y ACCESS_WIFI_STATE

Permite que la aplicación acceda a la información de red a través de la clase NetworkInfo.

CAMERA

Permite que la aplicación acceda a la cámara.

Nota: cuando se pide permiso para utilizar la función de cámara, Android entiende que la aplicación también requiere la cámara. Si la cámara es una función opcional de la aplicación, se debe añadir un elemento uses-feature al manifiesto para la cámara, establecido en atributo necesario en false . Consulte Filtro de compatibilidad con Android .

INTERNET

Permite que la aplicación realice solicitudes de red y permite la depuración remota.

READ_PHONE_STATE

Permite que el motor de ejecución de AIR silencie el audio durante las llamadas de teléfono. Este permiso se debe establecer si la aplicación reproduce audio mientras está en segundo plano.

RECORD_AUDIO

Permite que la aplicación acceda al micrófono.

WAKE_LOCK y DISABLE_KEYGUARD

Permite que la aplicación impida que el dispositivo entre en reposo con la configuración de la clase SystemIdleMode.

WRITE_EXTERNAL_STORAGE

Permite que la aplicación escriba en la tarjeta de memoria externa del dispositivo.

Por ejemplo, para establecer permisos para una aplicación que requiera todos los permisos, se puede añadir lo siguiente al descriptor de la aplicación:

<android> 
                            <manifestAdditions> 
                            <![CDATA[ 
                            <manifest> 
                            <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /> 
                            <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> 
                            <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> 
                            <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> 
                            <uses-permission android:name="android.permission.CAMERA" /> 
                            <uses-permission android:name="android.permission.DISABLE_KEYGUARD" /> 
                            <uses-permission android:name="android.permission.INTERNET" /> 
                            <uses-permission android:name="android.permission.READ_PHONE_STATE" /> 
                            <uses-permission android:name="android.permission.RECORD_AUDIO" /> 
                            <uses-permission android:name="android.permission.WAKE_LOCK" /> 
                            <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> 
                            </manifest> 
                            ]]> 
                            </manifestAdditions> 
                            </android>

Puede utilizar un esquema de URI personalizado para iniciar una aplicación de AIR desde una página web o una aplicación nativa de Android. La compatibilidad con URI personalizado se basa en los filtros prácticos especificados en el manifiesto de Android, por lo que esta técnica no se puede utilizar en otras plataformas.

Para usar un URI personalizado, añada un filtro práctico al descriptor de la aplicación en el bloque <android> . Ambos elementos intent-filter del siguiente ejemplo se deben especificar. Edite la sentencia <data android:scheme=" my-customuri "/> para reflejar la cadena URI para el esquema personalizado.

<android> 
                            <manifestAdditions> 
                            <![CDATA[ 
                            <manifest> 
                            <application> 
                            <activity> 
                            <intent-filter> 
                            <action android:name="android.intent.action.MAIN"/> 
                            <category android:name="android.intent.category.LAUNCHER"/> 
                            </intent-filter> 
                            <intent-filter> 
                            <action android:name="android.intent.action.VIEW"/> 
                            <category android:name="android.intent.category.BROWSABLE"/> 
                            <category android:name="android.intent.category.DEFAULT"/> 
                            <data android:scheme="my-customuri"/> 
                            </intent-filter> 
                            </activity> 
                            </application> 
                            </manifest> 
                            ]]> 
                            </manifestAdditions> 
                            </android>

Un filtro práctico informa al sistema operativo Android de que la aplicación está disponible para realizar una operación concreta. En el caso de un URI personalizado, esto significa que el usuario ha hecho clic en un vínculo utilizando ese esquema de URI (y el navegador no sabe cómo gestionarlo).

Cuando la aplicación se invoca mediante un URI personalizado, el objeto NativeApplication distribuye un evento invoke . La URL del vínculo, incluyendo parámetros de consulta, se ubica en el conjunto arguments del objeto InvokeEvent. Se puede usar cualquier número de filtros prácticos.

El sistema operativo Android utiliza una serie de elementos en el archivo de manifiesto de la aplicación para determinar si la aplicación es compatible con un dispositivo concreto. La incorporación de esta información al archivo de manifiesto es opcional. Si no incluye estos elementos, la aplicación se puede instalar en cualquier dispositivo de Android. Sin embargo, puede que no funcione correctamente en cualquier dispositivo de Android. Por ejemplo, una aplicación de cámara no será útil en un teléfono que no disponga de cámara.

Etiquetas del archivo de manifiesto de Android que se pueden utilizar para filtro:

• supports-screens

• uses-configuration

• uses-feature

• uses-sdk (en AIR 3+)

<android> 
                                <manifestAdditions> 
                                <![CDATA[ 
                                <manifest> 
                                <uses-permission android:name="android.permission.CAMERA" /> 
                                <uses-feature android:name="android.hardware.camera" android:required="false"/> 
                                <uses-feature android:name="android.hardware.camera.autofocus" android:required="false"/> 
                                <uses-feature android:name="android.hardware.camera.flash" android:required="false"/> 
                                </manifest> 
                                ]]> 
                                </manifestAdditions> 
                                </android>

<android> 
                                <manifestAdditions> 
                                <![CDATA[ 
                                <manifest> 
                                <uses-permission android:name="android.permission.RECORD_AUDIO" /> 
                                <uses-feature android:name="android.hardware.microphone" android:required="false"/> 
                                </manifest> 
                                ]]> 
                                </manifestAdditions> 
                                </android>

Se pude permitir que la aplicación se instale o se mueva a la tarjeta de memoria externa, estableciendo el atributo installLocation del elemento manifest de Android en auto o preferExternal :

<android> 
                            <manifestAdditions> 
                            <![CDATA[ 
                            <manifest android:installLocation="preferExternal"/> 
                            ]]> 
                            </manifestAdditions> 
                            </android>

El sistema operativo Android no garantiza que la aplicación se instalará en la memoria externa. Un usuario también puede mover la aplicación entre la memoria interna y externa utilizando la aplicación de configuración del sistema.

Aun instalada en la memoria externa, los datos de usuario y la caché de la aplicación como, por ejemplo, el contenido del directorio de almacenamiento de la aplicación, los objetos compartidos y los archivos temporales, aún se almacenan en la memoria interna. Para evitar el uso de demasiada memoria interna, sea selectivo respecto a los datos que se guardan en el directorio de almacenamiento de la aplicación. Las grandes cantidades de datos se deben guardar en SDCard utilizando las ubicaciones File.userDirectory o File.documentsDirectory (que ambas asignaciones en la raíz de la tarjeta SD en Android).

En Android 3.0+, una aplicación debe activar la aceleración por hardware en el elemento de la aplicación de Android para que el contenido del plug-in se visualice en un objeto StageWebView. Para activar el procesamiento mediante plugin, establezca el atributo android:hardwareAccelerated del elemento application en true :

<android> 
                            <manifestAdditions> 
                            <![CDATA[ 
                            <manifest> 
                            <application android:hardwareAccelerated="true"/> 
                            </manifest> 
                            ]]> 
                            </manifestAdditions> 
                            </android>

En AIR 3 y versiones posteriores, el motor de ejecución establece la visualización con representación de colores de 32 bits. En versiones anteriores de AIR, el motor de ejecución utiliza colores de 16 bits. Puede hacer que el motor de ejecución utilice colores de 16 bits con el elemento <colorDepth> del descriptor de la aplicación:

<android> 
                            <colorDepth>16bit</colorDepth> 
                            <manifestAdditions>...</manifestAdditions> 
                            </android>

Con profundidad de color de 16 bits se puede aumentar el rendimiento de procesamiento, pero a costa de la fidelidad de los colores.