Unable to read Dashboard config. Please confirm that your Branch key is properly added to the manifest. ( Flutter )

Edafe — Mon, 14 Apr 2025 07:48:40 +0000

I was integrating deeplinking using branch.io when i encountered the above error on android ( flutter )

** ERROR ** : Unable to read Dashboard config. Please confirm that your Branch key is properly added to the manifest. Please fix your Dashboard settings.

Please follow the link for more info https://branch.app.link/link-settings-page

It said my dashboard was not configured even though i have correctly added the necessary files in my AndroidManifest

After hours searching and debugging every line, i found the root cause ( in my case of course )

The Main Cause

AppTrackingStatus status = await FlutterBranchSdk.requestTrackingAuthorization();

I was calling the above method to request app tracking, the mistake was that i wasn't checking if the platform was iOS.

The above method was only supposed to be called on iOS and not Android. But in my section of the code i forgot to add to check for platform

Don't call the above method on android, do a platform check first

NOTE : This is only a short note on the above error and you might need to do further research is your use case is different

## Please leave a reaction/comment if you found this helpful

Flutter : Your scoped storage permission declaration needs to be updated.

Edafe — Mon, 02 Sep 2024 07:19:17 +0000

I was publishing an android build using codemagic.io when the process failed with this error.

Short Summary on Scoped storage

Of course the first thing i had to do was to research scope storage.

Scope storage is all about the android OS restricting the storage access your app has on the device. In earlier versions of the Android OS, your app has storage access to wide number of locations/folder within the device. This unlimited storage access poses a threat as bad actors can take advantage of it hence the need to restrict it.

The Main Cause

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

In my case, having the above permission in my AndroidManifest.xml triggered the error

This permission is mostly provided to app such as file explorer.

That does not mean it's a dead end if your app requires this permission. You would just have to update your permission ( Maybe by writing to the playstore review/policy team - ).

But for a lot of app use cases, you wouldn't need this permission.

The above permission is different from these two permission below and they don't trigger the error,

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

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

NOTE : This is only a short note on the above error and you might need to do further research is your use case is different

Forem: Edafe

Unable to read Dashboard config. Please confirm that your Branch key is properly added to the manifest. ( Flutter )

The Main Cause

Don't call the above method on android, do a platform check first

NOTE : This is only a short note on the above error and you might need to do further research is your use case is different

## Please leave a reaction/comment if you found this helpful

Flutter : Your scoped storage permission declaration needs to be updated.

Short Summary on Scoped storage

The Main Cause