--- title: "Implementar Flutter SDK" url: https://docs.catalyst.zoho.com/es/sdk/flutter/v2/implement-flutter-sdk/ description: "Después de configurar el entorno de trabajo para desarrollar la aplicación Flutter en Android o iOS, debes instalar, importar e inicializar Flutter SDK en tu proyecto." last_updated: 2026-03-20T16:21:56Z service: All Services type: general related_links: - name: "Environments" url: /es/deployment-and-billing/environments/introduction/#introduction --- # Implementar Flutter SDK en tu proyecto Después de configurar el entorno de trabajo para desarrollar la aplicación Flutter principalmente en Android o iOS y crear el proyecto Flutter en el IDE, ahora puedes proceder a implementar el Catalyst Flutter SDK en tu proyecto Flutter. Cuando creas un proyecto Flutter, un archivo básico [`pubspec.yaml`](https://docs.flutter.dev/tools/pubspec) se genera y se ubica en la parte superior del árbol del proyecto. Este archivo contiene los metadatos sobre el proyecto y especifica las dependencias que requiere el proyecto. ### Instalar el SDK Necesitarás agregar las siguientes configuraciones para implementar el Catalyst Flutter SDK en el `pubspec.yaml` de tu proyecto Flutter: ```bash dependencies: zcatalyst_sdk: ^2.2.1 ``` Para instalar el Flutter SDK en tu proyecto, necesitarás ejecutar el siguiente comando desde la terminal de tu IDE: ```bash flutter pub get ``` > **Nota**: También puedes obtener este paquete de las siguientes maneras en tu IDE: * VS Code: Haz clic en **Get Packages** ubicado en el lado derecho de la cinta de acciones en la parte superior de `pubspec.yaml` indicado por el ícono de descarga. * Android Studio/IntelliJ: Haz clic en **Pub get** en la cinta de acciones en la parte superior de `pubspec.yaml`. #### Método alternativo para instalar el SDK: Puedes ejecutar el siguiente comando directamente desde la terminal de tu IDE en el directorio de tu proyecto Flutter para instalar el Flutter SDK, en lugar de agregar las configuraciones en el archivo `pubspec.yaml` como se mencionó anteriormente: ```bash flutter pub add zcatalyst_sdk ``` ### Importar el SDK Para importar el SDK en el código Dart, necesitarás agregar la siguiente línea de código en el archivo `lib`/`main.dart` en el directorio de tu proyecto Flutter: ```bash import 'package:zcatalyst_sdk/zcatalyst_sdk.dart'; ``` ### Inicializar el SDK Debes inicializar el SDK de Catalyst para habilitar el funcionamiento de los métodos y funcionalidades definidos en el paquete del SDK. Por lo tanto, antes de configurar tu aplicación para consumir los métodos del SDK, debes inicializar el SDK en tu función `main()` usando el método `ZCatalystApp.init()` de cualquiera de las siguientes maneras: #### 1. Usando el archivo de configuración de Catalyst: La función de configuración que descargaste anteriormente para [Android](https://docs.catalyst.zoho.com/es/sdk/flutter/v2/setup-for-android/#step-1-register-your-android-app-with-catalyst) o [iOS](https://docs.catalyst.zoho.com/es/sdk/flutter/v2/setup-for-ios/#step-1-register-your-ios-app-with-catalyst) indicará el entorno de la aplicación. De manera similar a incluir el archivo de configuración apropiado (`app_configuration_development.properties` / `app_configuration_production.properties` para Android y `AppConfigurationDevelopment.plist` / `AppConfigurationProduction.plist` para iOS) según el [entorno](https://docs.catalyst.zoho.com/es/deployment-and-billing/environments/introduction) en el proyecto de tu aplicación, debes inicializar el SDK para el entorno apropiado. **Especificando el entorno:** En este método, debes establecer la configuración requerida y especificar el `environment` de tu aplicación como `DEVELOPMENT` o `PRODUCTION`, y pasarlo al método `init()` a través de la clase `ZCatalystApp` como se muestra a continuación: ```bash ZCatalystApp.init({ ZCatalystEnvironment? environment, }); ``` A continuación se muestra un fragmento de código de ejemplo: ```bash void main() async { try { await ZCatalystApp.init(environment: ZCatalystEnvironment.DEVELOPMENT); } on ZCatalystException catch (ex) { print('Initialized Failed: ${ex.toString()}'); } } ``` **Sin especificar el entorno:** Si el `environment` no se especifica en la inicialización del SDK, se considerará como `PRODUCTION` por defecto. Por lo tanto, si tu aplicación está operando en el entorno de Production, puedes inicializar el SDK directamente de la siguiente manera: ```bash await ZCatalystApp.init(); ``` A continuación se muestra un fragmento de código de ejemplo: ```bash void main() async { try { await ZCatalystApp.init(); } on ZCatalystException catch (ex) { print('Initialized Failed: ${ex.toString()}'); } } ``` > **Nota**: Si realizas algún cambio en el archivo de configuración de Android o iOS, debes reinicializar el SDK. #### 2. Pasando el objeto de configuración SDK personalizado: Alternativamente, puedes inicializar el Flutter SDK construyendo un objeto `ZCatalystSDKConfigs` personalizado que puedes pasar usando la clase `ZCatalystSDKConfigsBuilder`. **Objeto ZCatalystSDKConfigs** La clase `ZCatalystSDKConfigsBuilder` tiene las siguientes propiedades de configuración:
Propiedades Tipo de dato Descripción
`environment` `ZCatalystEnvironment` El [entorno](https://docs.catalyst.zoho.com/es/deployment-and-billing/environments/introduction) bajo el cual la aplicación se está ejecutando actualmente
`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](https://docs.catalyst.zoho.com/es/deployment-and-billing/environments/development-environment/#function-url-and-web-app-url-in-the-development-environment) o [URL de producción](https://docs.catalyst.zoho.com/es/deployment-and-billing/environments/production-environment/#function-url-and-web-app-url-in-the-production-environment)), según el entorno en el que estés trabajando.
`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.
`projectID` int El [ID único](https://docs.catalyst.zoho.com/es/getting-started/set-up-a-catalyst-project/general-settings/) de tu proyecto de Catalyst
`redirectURL` String La URL de callback de tu aplicación que proporcionaste al crear un paquete para [Android](https://docs.catalyst.zoho.com/es/sdk/flutter/v2/setup-for-android/) o [iOS](https://docs.catalyst.zoho.com/es/sdk/flutter/v2/setup-for-ios/) en la consola
`portalID` String Identificador único recibido en el archivo de configuración al configurar la aplicación Android o iOS
`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í](https://docs.catalyst.zoho.com/es/api/oauth2/scopes/#Scopes).
`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
Este objeto `ZCatalystSDKConfigs` ahora se puede pasar usando la clase `ZCatalystSDKConfigsBuilder` como se muestra a continuación: ```bash ZCatalystSDKConfigs sdkConfigs = ZCatalystSDKConfigsBuilder( apiBaseURL: 'https://api.catalyst.zoho.com', accountsPortalBaseURL: 'https://accounts.zoho.com', clientID: '100****************************FX', clientSecret: '19ed***************************2s', environment: ZCatalystEnvironment.DEVELOPMENT, oauthScopes: 'ZOHOCATALYST.tables.rows.ALL, ZOHOCATALYST.tables.columns.ALL', portalID: '10******79', projectID: 28*******90, redirectURL: '*****') .setUserAgent("ZCatalyst Sample App") .build(); try { await ZCatalystApp.init(sdkConfigs: sdkConfigs); } on ZCatalystException catch (ex) { print('Initialized Failed: ${ex.toString()}'); } ```