Comenzar para Android

# Comenzar para Android

Para construir tu aplicación móvil Flutter con Android como objetivo de desarrollo principal con el Flutter SDK, necesitarás configurar el entorno requerido para desarrollar una aplicación Android en Catalyst.

### Prerrequisitos y entornos mínimos compatibles

Antes de comenzar a trabajar con tu aplicación Flutter en la plataforma Android, debes asegurarte de cumplir con los siguientes prerrequisitos y configurar estos entornos mínimos compatibles:

* {{%link href="https://docs.flutter.dev/get-started/test-drive?tab=androidstudio"%}}Crear un proyecto Flutter en Android Studio o cualquier IDE compatible{{%/link%}}

* Asegúrate de que tu proyecto Android cumpla con estos entornos mínimos compatibles:

* SO- Android API Level 21 (Lollipop 4.4)
  * Kotlin- 1.3.20
  * Gradle- 3.4.0

* Configurar un dispositivo o un emulador en tu IDE para ejecutar tu aplicación

Puedes registrar tu aplicación con Catalyst y descargar el archivo de configuración que se proporciona adaptado a tu aplicación. Debes incluir este archivo de configuración en la estructura de tu aplicación Android, ya que contendrá las definiciones de ciertas propiedades requeridas para que tu aplicación funcione correctamente.

<br>

## Configuración

Después de cumplir con los prerrequisitos para las configuraciones de Flutter y Android, sigue estos pasos para configurar e integrar el paquete de Android con tu aplicación.

### Paso 1: Registrar tu aplicación Android con Catalyst

Puedes comenzar creando un paquete para la aplicación Android en Catalyst para registrarla, y descargando su archivo de configuración único.

1. Haz clic en el ícono de Settings desde tu consola de Catalyst en tu proyecto.

2. Navega a **Developer Tools** bajo {{%italics%}}Project Settings{{%/italics%}} en el menú de configuración, luego haz clic en el mosaico de **Android**.
Alternativamente, puedes hacer clic en el botón **Add Package** a continuación.

<br />

3. Ingresa un nombre de paquete que lo identifique de forma única. Proporciona la URL para redirigir al usuario final después de que inicie sesión en la aplicación, como la URL de redirección.
Los valores que ingreses aquí se llenarán automáticamente en el archivo de configuración.

{{%note%}} {{%bold class="bold-primary"%}}Nota{{%/bold%}}: Un nombre de paquete estará asociado de forma única con ese SO. Por lo tanto, no puedes crear paquetes con el mismo nombre para aplicaciones Android e iOS. Debes proporcionar valores únicos.{{%/note%}}
  Asegúrate de que Android esté seleccionado como el tipo de SO.

<br />

4. Haz clic en **Create** para crear el paquete del SDK móvil.

5. La consola mostrará entonces una ventana desde donde puedes descargar el archivo de configuración. Haz clic en **Download** para descargar el archivo.

El archivo se descargará con todas las configuraciones requeridas. Las propiedades de este archivo se explican en el siguiente paso.

<br />

### Paso 2: Importar el archivo de configuración en tu proyecto Android

Catalyst proporciona dos entornos de trabajo para desarrollar y construir tus aplicaciones: un sandbox de **Development** y un entorno de **Production** en vivo. Puedes aprender más sobre ellos en la {{%link href="/es/deployment-and-billing/environments/introduction"%}}página de ayuda de Environments{{%/link%}}.

Cuando creas un paquete en la consola, solo el archivo de configuración del entorno de desarrollo estará disponible para descargar inicialmente, independientemente del entorno en el que estés trabajando actualmente. Puedes elegir descargar el archivo de configuración desde la consola para cualquier entorno en cualquier momento, una vez que el paquete haya sido creado.

Los archivos de configuración de cada entorno se nombrarían como:
* Development: {{%badge%}}**app_configuration_development.properties**{{%/badge%}}
* Production: {{%badge%}}**app_configuration_production.properties**{{%/badge%}}

Según el entorno en el que estés trabajando, debes descargar y agregar el archivo apropiado a la estructura de tu aplicación Android. Para obtener un archivo de configuración del entorno de producción, primero debes {{%link href="/es/deployment-and-billing/environments/initial-deployment"%}}desplegar tu proyecto a producción{{%/link%}} y luego {{%link href="/es/getting-started/set-up-a-catalyst-project/developer-tools"%}}descargar el archivo{{%/link%}} desde la sección de configuración de {{%italics%}}Developer Tools{{%/italics%}}.

El archivo de configuración debe agregarse al directorio {{%badge%}}**assets**{{%/badge%}} del módulo de tu aplicación Android. Típicamente, la carpeta {{%badge%}}assets{{%/badge%}} se crea en el directorio {{%badge%}}app/src/main{{%/badge%}}.

Consulta la {{%link href="https://developer.android.com/studio/projects"%}}documentación oficial de Android{{%/link%}} para ayuda detallada sobre los módulos de aplicaciones Android.

<br />

#### Propiedades del archivo app_configuration_development.properties/ app_configuration_production.properties

El archivo de configuración de la aplicación define las propiedades mencionadas en la tabla a continuación. Todos estos valores excepto los encabezados de solicitud se rellenan automáticamente, según los detalles de tu proyecto o los estándares predeterminados.

{{%note%}} {{%bold class="bold-primary"%}}Nota{{%/bold%}}: Puedes consultar los enlaces especificados en la tabla para saber dónde puedes obtener estos valores.{{%/note%}}

<table class="content-table">
<thead>
<tr>
<th class="w20p">Propiedad</th>
<th class="w20p">Tipo de dato</th>
<th class="w60p">Descripción</th>
</tr>
</thead>
<tbody>
<tr> 
<td>{{%badge%}}**clientID**{{%/badge%}}</td>
<td>String</td>
<td>Identificador único de tu cliente de aplicación registrado en Catalyst. Se recibe en el archivo de configuración.</td>
</tr>

<tr> 
<td>{{%badge%}}**clientSecret**{{%/badge%}}</td>
<td>String</td>
<td>Valor secreto generado para un {{%badge%}}clientID{{%/badge%}} específico, que se pasa junto con las llamadas API. Se recibe en el archivo de configuración.</td>
</tr>

<tr> 
<td>{{%badge%}}**portalID**{{%/badge%}}</td>
<td>String</td>
<td>Identificador único recibido en el archivo de configuración</td>
</tr>
<tr> 
<td>{{%badge%}}**redirectUrl**{{%/badge%}}</td>
<td>String</td>
<td>La URL de callback de tu aplicación que proporcionaste al crear un paquete para ella en la consola, en el paso anterior</td>
</tr>
<tr> 
<td>{{%badge%}}**projectID**{{%/badge%}}</td>
<td>Long</td>
<td>El {{%link href="/es/getting-started/set-up-a-catalyst-project/general-settings/" %}}ID único{{%/link%}} de tu proyecto de Catalyst</td>
</tr> 
<tr>
<td>{{%badge%}}**apiBaseURL**{{%/badge%}}</td>
<td>String</td>
<td>La URL del servidor de Catalyst a través de la cual se llama la API interna. Debes usar la URL apropiada ({{%link href="/es/deployment-and-billing/environments/development-environment/#function-url-and-web-app-url-in-the-development-environment"%}}URL de desarrollo{{%/link%}} o {{%link href="/es/deployment-and-billing/environments/production-environment/#function-url-and-web-app-url-in-the-production-environment"%}}URL de producción{{%/link%}}), según el entorno en el que estés trabajando.</td>
</tr>
<tr>
<td>{{%badge%}}**oauthScopes**{{%/badge%}}</td>
<td>String</td>
<td>Los alcances que usaría la aplicación para acceder a las APIs de Catalyst desde tu proyecto. Puedes encontrar los alcances OAuth disponibles {{%link href="/es/api/oauth2/scopes/#Scopes" %}}aquí{{%/link%}}.</td>
</tr>
<tr>
<td>{{%badge%}}**requestHeaders**{{%/badge%}}</td>
<td>String</td>
<td>Los encabezados que enviaría el cliente en las solicitudes HTTP<br /> Los valores de los encabezados de solicitud deben ser pares clave-valor individuales, separados por comas como: {{%badge%}}requestHeaders={{%/badge%}}{{%italics%}}key1:value1, key2:value2{{%/italics%}}</td>
</tr>
<tr>
<td>{{%badge%}}**serverTLD**{{%/badge%}}</td>
<td>String</td>
<td>El dominio de nivel superior del servidor de datos<br /> Valores aceptables: {{%badge%}}**AU**{{%/badge%}}, {{%badge%}}**CN**{{%/badge%}}, {{%badge%}}**COM**{{%/badge%}}, {{%badge%}}**EU**{{%/badge%}} e {{%badge%}}**IN**{{%/badge%}}</td>
</tr>
<tr>
<td>{{%badge%}}**printStackTrace**{{%/badge%}}</td>
<td>Boolean</td>
<td>Te permite obtener un rastreo detallado de los logs, si el valor de {{%badge%}}**printStackTrace**{{%/badge%}} se establece como '{{%bold%}}true{{%/bold%}}'. El valor predeterminado es '{{%bold%}}false{{%/bold%}}'.</td>
</tr>
<tr>
<td>{{%badge%}}**minLogLevel**{{%/badge%}}</td>
<td>String</td>
<td>Te permite establecer las preferencias de registro para la aplicación<br /> Valores aceptables: {{%badge%}}**warnings**{{%/badge%}}, {{%badge%}}**errors**{{%/badge%}}, {{%badge%}}**information**{{%/badge%}}, {{%badge%}}**debug**{{%/badge%}}, {{%badge%}}**ALL**{{%/badge%}}</td>
</tr>
<tr>
<td>{{%badge%}}**httpRequestMode**{{%/badge%}}</td>
<td>String</td>
<td>Define si las solicitudes HTTP son síncronas o asíncronas<br /> Valores aceptables: {{%badge%}}**SYNC**{{%/badge%}}, {{%badge%}}**ASYNC**{{%/badge%}}<br /> Valor predeterminado: {{%badge%}}ASYNC{{%/badge%}}</td>
</tr>
<tr>
<td>{{%badge%}}**connectTimeOut<br>InSec**{{%/badge%}}</td>
<td>Long</td>
<td>El valor de tiempo de espera de conexión (en segundos) de la solicitud HTTP enviada desde el SDK<br /> Es decir, si no se recibe una respuesta a la solicitud del cliente desde el servidor dentro de este tiempo, la conexión se terminará</td>
</tr>
<tr>
<td>{{%badge%}}**readTimeOutInSec**{{%/badge%}}</td>
<td>Long</td>
<td>El valor de tiempo de espera de lectura (en segundos) de la solicitud HTTP enviada desde el SDK<br /> Es decir, si no se reciben datos del servidor dentro de este tiempo, la conexión se terminará</td>
</tr>
<tr>
<td>{{%badge%}}**writeTimeOutInSec**{{%/badge%}}</td>
<td>Long</td>
<td>El valor de tiempo de espera de escritura (en segundos) de la solicitud HTTP enviada desde el SDK<br /> Es decir, si la solicitud no logra escribir o enviar los datos de la solicitud al servidor dentro de este tiempo, la conexión se terminará</td>
</tr>
<tr>
<td>{{%badge%}}**JWTClientID**{{%/badge%}}</td>
<td>String</td>
<td>La propiedad de ID de cliente del token de servidor personalizado (token JSON Web Token) generado para autenticación de terceros que se pasará al cliente</td>
</tr>
<tr>
<td>{{%badge%}}**JWTClientSecret**{{%/badge%}}</td>
<td>String</td>
<td>La propiedad de secreto de cliente del token de servidor personalizado (token JSON Web Token) generado para autenticación de terceros que se pasará al cliente</td>
</tr>
</tbody>
</table>

{{%note%}}{{%bold%}}Nota{{%/bold%}}:<br />

* Si los valores de {{%badge%}}**clientID**{{%/badge%}}, {{%badge%}}**clientSecret**{{%/badge%}}, {{%badge%}}**projectID**{{%/badge%}} o {{%badge%}}**portalID**{{%/badge%}} se modifican en el archivo de configuración, afectará el funcionamiento del SDK y tu aplicación Android. Si deseas cambiar alguna de estas configuraciones, puedes {{%link href="/es/getting-started/set-up-a-catalyst-project/developer-tools/#create-a-mobile-sdk-package" %}}crear un nuevo paquete{{%/link%}} para el proyecto requerido desde la sección de Developer Tools y descargar un nuevo archivo de configuración para el entorno apropiado, y agregarlo al directorio {{%badge%}}assets{{%/badge%}} en la estructura de tu aplicación.

* Los valores de las propiedades que se rellenan en el archivo de configuración descargado se pueden acceder dinámicamente usando el objeto {{%badge%}}**ZCatalystApp.configs**{{%/badge%}}.{{%/note%}}

<br />

### Paso 3: Configurar la redirección de inicio de sesión de la aplicación

Cuando un usuario inicia sesión en tu aplicación exitosamente, será redirigido a la pantalla principal de tu aplicación. Este inicio de sesión y redirección del usuario es manejado por el SDK de Catalyst.

Para asegurar que esta redirección se maneje correctamente, incluye el esquema de URL que se muestra a continuación en el archivo {{%badge%}}strings.xml{{%/badge%}} de tu aplicación Android:
{{%code class="language-bash line-numbers"%}}&lt;string name="url_scheme"&gt;{redirection_url}&lt;/string&gt;
{{%/code%}}

El archivo {{%badge%}}strings.xml{{%/badge%}} se crea automáticamente cuando creas el proyecto Android. Puedes encontrarlo navegando a {{%badge%}}app/src/main/res/values{{%/badge%}} en la estructura de tu aplicación. El archivo ya contendrá la definición de cadena para el nombre de tu aplicación. Incluye esta cadena junto con ella.

Debes pasar la **URL de redirección** que configuraste al {{%link href="/es/sdk/android/v2/setup/#step-1-register-your-android-app-with-catalyst"%}}crear el paquete{{%/link%}} para tu aplicación en Catalyst, en lugar de {{%badge%}}redirection_url{{%/badge%}} en este código.

<br />

### Paso 4: Establecer los permisos requeridos

El SDK de Catalyst requiere que se habiliten los siguientes permisos de aplicación, para asegurar que tu aplicación funcione sin problemas y proporcionar una experiencia de usuario fluida:

* {{%badge%}}**INTERNET**{{%/badge%}}: Para ejecutar APIs de Catalyst
* {{%badge%}}**ACCESS_NETWORK_STATE**{{%/badge%}}: Para manejar fallos de red

Para habilitar estos permisos, debes declararlos en el archivo {{%badge%}}**AndroidManifest.xml**{{%/badge%}}, como se muestra a continuación:
{{%code class="language-bash line-numbers"%}}&lt;uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/&gt;
&lt;uses-permission android:name="android.permission.INTERNET"/&gt;
{{%/code%}}

Puedes encontrar el archivo {{%badge%}}AndroidManifest.xml{{%/badge%}} navegando a {{%badge%}}app/src/main{{%/badge%}} en la estructura de tu aplicación.

<br />

La configuración para construir una aplicación Flutter con Android como objetivo de desarrollo principal está lista. Ahora puedes proceder a {{%link href="/es/sdk/flutter/v2/implement-flutter-sdk/" %}}implementar Catalyst Flutter SDK en tu aplicación{{%/link%}}.

Prerrequisitos y entornos mínimos compatibles

Antes de comenzar a trabajar con tu aplicación Flutter en la plataforma Android, debes asegurarte de cumplir con los siguientes prerrequisitos y configurar estos entornos mínimos compatibles:

Crear un proyecto Flutter en Android Studio o cualquier IDE compatible
Asegúrate de que tu proyecto Android cumpla con estos entornos mínimos compatibles:
- SO- Android API Level 21 (Lollipop 4.4)
- Kotlin- 1.3.20
- Gradle- 3.4.0
Configurar un dispositivo o un emulador en tu IDE para ejecutar tu aplicación

Configuración

Después de cumplir con los prerrequisitos para las configuraciones de Flutter y Android, sigue estos pasos para configurar e integrar el paquete de Android con tu aplicación.

Paso 1: Registrar tu aplicación Android con Catalyst

Puedes comenzar creando un paquete para la aplicación Android en Catalyst para registrarla, y descargando su archivo de configuración único.

Haz clic en el ícono de Settings desde tu consola de Catalyst en tu proyecto.
Navega a Developer Tools bajo Project Settings en el menú de configuración, luego haz clic en el mosaico de Android. Alternativamente, puedes hacer clic en el botón Add Package a continuación.

Ingresa un nombre de paquete que lo identifique de forma única. Proporciona la URL para redirigir al usuario final después de que inicie sesión en la aplicación, como la URL de redirección. Los valores que ingreses aquí se llenarán automáticamente en el archivo de configuración.

Nota: Un nombre de paquete estará asociado de forma única con ese SO. Por lo tanto, no puedes crear paquetes con el mismo nombre para aplicaciones Android e iOS. Debes proporcionar valores únicos.

Asegúrate de que Android esté seleccionado como el tipo de SO.

Haz clic en Create para crear el paquete del SDK móvil.
La consola mostrará entonces una ventana desde donde puedes descargar el archivo de configuración. Haz clic en Download para descargar el archivo. El archivo se descargará con todas las configuraciones requeridas. Las propiedades de este archivo se explican en el siguiente paso.

Paso 2: Importar el archivo de configuración en tu proyecto Android

Catalyst proporciona dos entornos de trabajo para desarrollar y construir tus aplicaciones: un sandbox de Development y un entorno de Production en vivo. Puedes aprender más sobre ellos en la página de ayuda de Environments.

Los archivos de configuración de cada entorno se nombrarían como:

Development: app_configuration_development.properties
Production: app_configuration_production.properties

Según el entorno en el que estés trabajando, debes descargar y agregar el archivo apropiado a la estructura de tu aplicación Android. Para obtener un archivo de configuración del entorno de producción, primero debes desplegar tu proyecto a producción y luego descargar el archivo desde la sección de configuración de Developer Tools.

El archivo de configuración debe agregarse al directorio assets del módulo de tu aplicación Android. Típicamente, la carpeta assets se crea en el directorio app/src/main. Consulta la documentación oficial de Android para ayuda detallada sobre los módulos de aplicaciones Android.

Propiedades del archivo app_configuration_development.properties/ app_configuration_production.properties

Nota: Puedes consultar los enlaces especificados en la tabla para saber dónde puedes obtener estos valores.

Propiedad	Tipo de dato	Descripción
clientID	String	Identificador único de tu cliente de aplicación registrado en Catalyst. Se recibe en el archivo de configuración.
clientSecret	String	Valor secreto generado para un clientID específico, que se pasa junto con las llamadas API. Se recibe en el archivo de configuración.
portalID	String	Identificador único recibido en el archivo de configuración
redirectUrl	String	La URL de callback de tu aplicación que proporcionaste al crear un paquete para ella en la consola, en el paso anterior
projectID	Long	El ID único de tu proyecto de Catalyst
apiBaseURL	String	La URL del servidor de Catalyst a través de la cual se llama la API interna. Debes usar la URL apropiada (URL de desarrollo o URL de producción), según el entorno en el que estés trabajando.
oauthScopes	String	Los alcances que usaría la aplicación para acceder a las APIs de Catalyst desde tu proyecto. Puedes encontrar los alcances OAuth disponibles aquí.
requestHeaders	String	Los encabezados que enviaría el cliente en las solicitudes HTTP Los valores de los encabezados de solicitud deben ser pares clave-valor individuales, separados por comas como: requestHeaders=key1:value1, key2:value2
serverTLD	String	El dominio de nivel superior del servidor de datos Valores aceptables: AU, CN, COM, EU e IN
printStackTrace	Boolean	Te permite obtener un rastreo detallado de los logs, si el valor de printStackTrace se establece como 'true'. El valor predeterminado es 'false'.
minLogLevel	String	Te permite establecer las preferencias de registro para la aplicación Valores aceptables: warnings, errors, information, debug, ALL
httpRequestMode	String	Define si las solicitudes HTTP son síncronas o asíncronas Valores aceptables: SYNC, ASYNC Valor predeterminado: ASYNC
connectTimeOut InSec	Long	El valor de tiempo de espera de conexión (en segundos) de la solicitud HTTP enviada desde el SDK Es decir, si no se recibe una respuesta a la solicitud del cliente desde el servidor dentro de este tiempo, la conexión se terminará
readTimeOutInSec	Long	El valor de tiempo de espera de lectura (en segundos) de la solicitud HTTP enviada desde el SDK Es decir, si no se reciben datos del servidor dentro de este tiempo, la conexión se terminará
writeTimeOutInSec	Long	El valor de tiempo de espera de escritura (en segundos) de la solicitud HTTP enviada desde el SDK Es decir, si la solicitud no logra escribir o enviar los datos de la solicitud al servidor dentro de este tiempo, la conexión se terminará
JWTClientID	String	La propiedad de ID de cliente del token de servidor personalizado (token JSON Web Token) generado para autenticación de terceros que se pasará al cliente
JWTClientSecret	String	La propiedad de secreto de cliente del token de servidor personalizado (token JSON Web Token) generado para autenticación de terceros que se pasará al cliente

Nota:

Si los valores de clientID, clientSecret, projectID o portalID se modifican en el archivo de configuración, afectará el funcionamiento del SDK y tu aplicación Android. Si deseas cambiar alguna de estas configuraciones, puedes crear un nuevo paquete para el proyecto requerido desde la sección de Developer Tools y descargar un nuevo archivo de configuración para el entorno apropiado, y agregarlo al directorio assets en la estructura de tu aplicación.
Los valores de las propiedades que se rellenan en el archivo de configuración descargado se pueden acceder dinámicamente usando el objeto ZCatalystApp.configs.

Paso 3: Configurar la redirección de inicio de sesión de la aplicación

Para asegurar que esta redirección se maneje correctamente, incluye el esquema de URL que se muestra a continuación en el archivo strings.xml de tu aplicación Android:

copy

         <string name="url_scheme">{redirection_url}</string>

El archivo strings.xml se crea automáticamente cuando creas el proyecto Android. Puedes encontrarlo navegando a app/src/main/res/values en la estructura de tu aplicación. El archivo ya contendrá la definición de cadena para el nombre de tu aplicación. Incluye esta cadena junto con ella.

Debes pasar la URL de redirección que configuraste al crear el paquete para tu aplicación en Catalyst, en lugar de redirection_url en este código.

Paso 4: Establecer los permisos requeridos

El SDK de Catalyst requiere que se habiliten los siguientes permisos de aplicación, para asegurar que tu aplicación funcione sin problemas y proporcionar una experiencia de usuario fluida:

INTERNET: Para ejecutar APIs de Catalyst
ACCESS_NETWORK_STATE: Para manejar fallos de red

Para habilitar estos permisos, debes declararlos en el archivo AndroidManifest.xml, como se muestra a continuación:

copy

         <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.INTERNET"/>

Puedes encontrar el archivo AndroidManifest.xml navegando a app/src/main en la estructura de tu aplicación.

La configuración para construir una aplicación Flutter con Android como objetivo de desarrollo principal está lista. Ahora puedes proceder a implementar Catalyst Flutter SDK en tu aplicación.

Última actualización 2026-03-20 21:51:56 +0530 IST

Yes

Thank you for your feedback!

Send your feedback to us

Skip

Submit

Environments Developer Tools Android SDK