Common Questions

1. What if I receive "currentActivity not found" error?

       Please export the package and test it on a real device.

2. Does Android SDK distinguish between Android X and Android Support versions?

       No, it doesn't.

3. What to do if 404 is returned when reporting data through API?

       Please use the POST method to request data. The GET requests are currently not supported.

4. What to do if code=500 is returned when reporting data through API?

Response result:

{
    "code": 500,
    "msg": "no parameter received"
}

• Check whether the body parameter format is an array.
• Check if body is an empty array.

5. Debug using the iOS simulator in Unity environment

      Starting from SE iOS SDK 1.2.7.2, the delivery mode has changed to .xcframeworks. In Unity environment, only ios-arm64 is retained, otherwise compilation errors may occur.

      If you want to debug using the iOS simulator in Unity environment, you need to download the iOS SDK: https://help.solar-engine.com/en/docs/b2scLf .

      After decompression, replace "Assets/Plugins/iOS/framework/SolarEngineSDK.xcframework/ios-arm64" in your Unity project with "SolarEngineSDK.xcframework/ios-x86_64-simulator". Similarly, replace the Unity peoject's "Assets/Plugins/iOS/framework/SESDKRemoteConfig.xcframework/ios-arm64" with "SESDKRemoteConfig.xcframework/ios-x86_64-simulator".

      Remember to switch back to "ios-arm64" when releasing the app after debugging.

6. Manually Integrate iOS SDK in Unity

1. Delete the SolarEngineNet/iOS folder.
2. Delete the SolarEngineNet/Editor/SolarEnginePlugins/RemoteConfigSDK/iOS folder.
3. Refer to iOS document to obtain the SDK, and place the SDK into the project at Assets/Plugins/SolarEngine/iOS.

   Add Required SDK Dependency Frameworks:

• Use Security.framework to store device identifiers.
• Use CoreTelephony.framework to obtain carrier information.
• Use AdSupport.framework to get Advertising Identifier information.
• Use SystemConfiguration.framework to check the current network environment.
• Use libsqlite3.dylib to store data.
• Use AdServices.framework to retrieve advertising attribution data.

  How to add these frameworks above?

   In the project directory, select TARGETS → Build Phases → Link Binary With Libraries → + → choose Security.framework, SystemConfiguration.framework, CoreTelephony.framework, AdSupport.framework, libsqlite3.dylib, AdServices.framework, and other library files.

   Why and how to add the -Objc parameter?

   The -Objc parameter should be added in the UnityFramework Target; otherwise the SDK initialization will fail.

   Go to TARGETS → UnityFramework → Build Settings → Other Linker Flags → add -Objc.

   Note:

1. All the above dynamic libraries should be configured to avoid errors.
2. In Xcode 7 and later, system libraries that ended with .dylib have been changed to end with the .tbd suffix.

7. Resolving iOS ODMInfo Conflicts in Unity Project (Version 1.3.0.9 and Above)

       iOS ODMInfo depends on the following frameworks:

• GoogleAdsOnDeviceConversion.xcframework
• GoogleUtilities.xcframework
• nanopb.xcframework

If your project also uses Firebase features, there may be conflicts due to inconsistent dependency versions. The steps to resolve the conflicts are as follows:

• Open the SolarEngineNet-SolarEnginePlugins-ODMInfo-Editor-Dependencies file.
• Comment out the conflicting pod node (usually GoogleAdsOnDeviceConversion).

• Last step: re-export the iOS project, uninstall the app, and reinstall it. Then search for the keyword "ODM".

8. What should be done after I update Unity SDK version to v1.3.0.0?

       If you previously integrated our Unity SDK that is not the .unitypackage format, please make sure to delete the manually placed SolarEngineSDK from your project.

1. Android/libs/se_remote_config_unity_bridge.jar
2. Android/libs/solar_engine_unity_bridge.jar
3. Editor/InstallSESDKXcode.cs
4. Editor/Resources/SolarEngineSettings.asset
5. Editor/SolarEngineSettings.cs
6. Editor/SolarEngineSettingsEditor.cs
7. iOS/framework/SESDKRemoteConfig.xcframework
8. iOS/framework/SolarEngineSDK.xcframework
9. iOS/wrappers/SESDKRemoteConfigUnityBridge.h
10. iOS/wrappers/SESDKRemoteConfigUnityBridge.mm
11. iOS/wrappers/SolarEngineSDKUnityBridge.h
12. iOS/wrappers/SolarEngineSDKUnityBridge.mm
13. iOS/wrappers/SolarEngineUnityAppDelegate.h
14. iOS/wrappers/SolarEngineUnityAppDelegate.m
15. Newtonsoft.Json.dll
16. SESDKRemoteConfig.cs
17. SolarEngine.cs

8. Upgrade iOS SDK version in Unity

   Due to caching by the iOS pod command when pulling the SDK, if you want to upgrade the iOS SDK version, you need to specify the desired version or the latest version in the SDK Edit Setting panel, and then click Apply.

9. How to deal with the error [java.lang.ClassNotFoundException: Didn't find class "com.reyun.solar.engine.SolarEngineManager"]?

   If you encounter this error when building and running an APK in Unity, please confirm whether the Unity project contains the corresponding .aar package for SolarEngine, for example:

   com.reyun.solar.engine.xxxx.xxx.aar

10. What if I failed to pull Android SDK in Unity?

   Please execute a force pull:

Assets > External Dependency Manager > Android Resolver > Resolve

Assets > External Dependency Manager > Android Resolver > Force Resolve)

11. When building a Unity 6 project into an APK and installing it on an Android device, the app icon does not appear on the home screen, or the app cannot be launched from the home screen.

Root Cause:  

(Applicable if using the AndroidManifest.xml provided by SolarEngine)

The launch activity declared in AndroidManifest.xml does not match the Application Entry Point set in Unity Player Settings.

For example: The manifest declares

com.unity3d.player.UnityPlayerActivity 

But GameActivity (new in Unity 6) is selected as the entry point in Unity Player Settings. During the build, Unity marks the unused entry activity as disabled.

Solutions:

1. Use GameActivity (for projects using UnityPlayerGameActivity as the launch entry).

Note: Unity 6 uses UnityPlayerGameActivity as the default launch entry.

Unity settings path:

Edit → Project Settings → Player → Android icon → Other Settings → Application Entry Point → Select GameActivity

Configuration in  AndroidManifest.xml:

<activity
    android:name="com.unity3d.player.UnityPlayerGameActivity"
    android:theme="@style/BaseUnityGameActivityTheme"
    android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
    <meta-data android:name="unityplayer.UnityActivity" android:value="true" />
    <meta-data android:name="android.app.lib_name" android:value="game" />
</activity>

2. Use Activity

Unity Settings path:

Edit → Project Settings → Player → Android icon → Other Settings → Application Entry Point → Select Activity