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, run pod install in the ios directory.
• 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 KeyThe unique identifier for your Airship project. It is used to authenticate the application for API calls. and App SecretA secret used to authorize requests for low-security API calls. It is intended to be embedded in your distributed application, and as such is limited in what it can do.. 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.