Troubleshooting Initialization

When following steps in Getting Started or Advanced Configuration, if you don’t see a channel ID in the logs or encounter errors during initialization, review the following common problems and solutions.

Installation Errors

If you encounter errors during installation:

• Verify that you’re using a compatible version of Flutter. See Requirements in Getting Started.
• Ensure all native dependencies are properly linked.
• Run flutter clean and flutter pub get to refresh dependencies.
• For iOS, verify Swift Package Manager is enabled (flutter config --enable-swift-package-manager). The plugin no longer supports CocoaPods.
• Check that your iOS and Android projects are correctly configured.

Initialization Errors

If you encounter errors during SDK initialization:

• Verify your credentials in the Airship dashboard. The credentials used by takeOff are your Airship project’s app keyUniquely identifies an Airship project. Paired with an app secret or master secret, it authenticates API requests for the project. and app secretAuthenticates API requests for an Airship project when paired with the app key. It is intended to be embedded in distributed applications and is limited to the API endpoints required for SDK operations.. To find them, select the dropdown menu () next to your project name, and then Project details.
• Ensure WidgetsFlutterBinding.ensureInitialized() runs first in main(), then Airship.takeOff, then runApp().
• Ensure site in your AirshipConfig is Site.us for US cloud projects or Site.eu for EU cloud projects.