Effects / Get started / Migration
Learn how to migrate your existing effects to Nosmai Effects with step-by-step instructions and examples.
Prerequisites
- Commit or archive a known-good release build.
- Record the current native binary, wrapper, package ID, bundle identifier, and CocoaPods lockfile.
- Keep the active Nosmai license key private and bound to the same signed app.
Replace legacy distribution names
| Legacy | Current |
|---|
https://github.com/nosmai/camera-sdk-android | https://github.com/nosmai/nosmai_effects_sdk_android |
https://github.com/nosmai/camera-sdk-ios | https://github.com/nosmai/nosmai_effects_sdk_ios |
https://github.com/nosmai/nosmai_camera_sdk_flutter | https://github.com/nosmai/nosmai_effects_sdk_flutter |
Flutter nosmai_camera_sdk | Flutter nosmai_effects_sdk |
| No official React Native release | @nosmai/react-native-effects-sdk stable 1.0.0 |
The stable iOS CocoaPod remains named NosmaiCameraSDK. That pod name is not a legacy repository reference and must not be renamed in the consuming Podfile.
Upgrade one layer at a time
- Replace the Android AAR with verified
3.0.4, or update the iOS pod to NosmaiCameraSDK ~> 3.0.4. - Clean and build the native application before changing a wrapper.
- Replace the Flutter dependency with
nosmai_effects_sdk: ^1.0.3, or install React Native 1.0.0 documented for the host framework. - Resolve CocoaPods and inspect
Podfile.lock for one Nosmai native version. - Remove duplicate legacy AARs, frameworks, pods, and package imports.
Verify the migration
- Build a signed release for each supported platform.
- Confirm the final license status becomes valid without exposing the key.
- Exercise preview lifecycle and camera switching repeatedly.
- Apply the Cloud Filters, backgrounds, and beauty settings used by the app.
- Capture, record, and test the app's streaming handoff.
- Compare signed binary size, memory, FPS, and thermal behavior with the saved baseline.
Common errors
| Symptom | Cause | Fix |
|---|
| Duplicate native symbols or classes | Both legacy and current native binaries are packaged | Keep exactly one AAR or one iOS distribution path |
| Flutter import cannot be resolved | Source still imports nosmai_camera_sdk | Update the dependency, import, and lockfile together |
| License becomes invalid after migration | The signed application identity or selected platform changed | Match the Console project to the actual release identity |
Next steps
References
