Troubleshooting

Android: the SDK AAR does not resolve

Registry install (default). The Android SDK (com.byterialab:alphyn-sdk) resolves from the Alphyn package registry through the custom Main Gradle Template, so a failed Android build usually means one of:

• Custom Main Gradle Template is off. Enable it under Player Settings > Publishing Settings so Unity uses Assets/Plugins/Android/mainTemplate.gradle.
• ALPHYN_REGISTRY_KEY is not set in the build environment (a 401, or “could not resolve com.byterialab:alphyn-sdk”). See SDK Registry Access.
• mainTemplate.gradle is not wired. Re-run alphyn-cli integrate and confirm with alphyn-cli doctor.

Offline install. If you used the self-contained plugin, ensure alphyn-sdk.aar is in Assets/AlphynSDK/Plugins/Android/.

iOS: xcframework Not Found

The iOS Alphyn.xcframework is bundled in the plugin on both the registry and the offline paths. Ensure it is in Assets/AlphynSDK/Plugins/iOS/.

JNI Errors on Android Device

Check that the native libraries are included for your target architecture.

SDK Not Initializing

Android:

1. Check Android logcat for detailed errors
2. Ensure minimum API level is 26+

iOS:

1. Check Xcode console for detailed errors
2. Ensure minimum iOS version is 15.0+
3. Verify the xcframework is properly linked in Xcode project settings

Editor Testing

The SDK provides mock data in Unity Editor. Deploy to Android device or iOS device for real security detection.