# Releases and compatibility

> Choose the current Android, iOS, Flutter, React Native, or Web release and avoid duplicate or mismatched native SDK binaries.

> For AI agents: the complete documentation index is at https://nosmai.com/llms/effects.txt

Product: Nosmai Effects
Group: reference
Source: https://nosmai.com/docs/effects/releases-and-compatibility/

## Current releases

| Component | Version | Distribution |
| --- | --- | --- |
| Android native SDK | `3.0.4` | Public GitHub release AAR |
| iOS CocoaPod | `3.0.4` | `NosmaiCameraSDK` |
| iOS framework archive | `v3.0.4` | Public GitHub release ZIP used by the `3.0.4` podspec |
| Flutter package | `1.0.2` | `nosmai_effects_sdk` on pub.dev and GitHub release `v1.0.2` |
| React Native | `1.0.0` | `@nosmai/react-native-effects-sdk` on npm and GitHub release `1.0.0` |
| Web | `0.2.0` developer preview | Authorized preview package |

Flutter `1.0.2` is the current public package. It uses Android Effects SDK
`3.0.4` and resolves `NosmaiCameraSDK ~> 3.0.4` on iOS. Its public GitHub tag
points to the same commit used for the verified pub.dev archive. The iOS
`3.0.4` pod downloads the verified framework archive published under GitHub
tag `v3.0.4`.

## Official public repositories

- [Android SDK](https://github.com/nosmai/nosmai_effects_sdk_android)
- [Flutter SDK](https://github.com/nosmai/nosmai_effects_sdk_flutter)
- [iOS SDK](https://github.com/nosmai/nosmai_effects_sdk_ios)
- [React Native SDK](https://github.com/nosmai/nosmai_effects_sdk_react_native)
- [Flutter package](https://pub.dev/packages/nosmai_effects_sdk)
- [React Native package](https://www.npmjs.com/package/@nosmai/react-native-effects-sdk)
- [iOS CocoaPod](https://cocoapods.org/pods/NosmaiCameraSDK)

React Native `1.0.0` is the current stable public npm release. The Web preview
remains available directly from Nosmai.

## Verify native downloads

Download the binary and `SHA256SUMS` from the same GitHub release, then run:

```sh
shasum -a 256 -c SHA256SUMS
```

The current public assets have these checksums:

```text
4804fc5bf502ca7aff46285562b8d0318d7d14f6ada8a9cb3112fc2188804284  nosmai-sdk-3.0.4.aar
f63f566f2580c25360d29e667308a127360e558198f05ad437ff1dd5e7a01157  nosmai.framework.zip
```

Do not integrate a file when verification fails.

## Compatibility rules

1. Keep exactly one Nosmai native binary per platform target.
2. Replace an old AAR instead of keeping both filenames in `app/libs`.
3. Use CocoaPods or manual framework embedding on iOS, not both.
4. Keep Android on Java 11, compile SDK 35, API 21 or later, and
   `arm64-v8a`.
5. Use a physical arm64 iPhone on iOS 15 or later; the current framework has no
   Simulator slice.
6. Test the exact `.nosmai` packages and final signed application identity.

## Upgrade checklist

- Read the release notes for every changed layer.
- Verify new native artifacts before replacing the previous version.
- Clean the native or Flutter build after binary changes.
- Resolve CocoaPods again and inspect `Podfile.lock`.
- Test license status, camera lifecycle, effects, Cloud Filters, capture,
  recording, games, and streaming on physical devices.
- Compare the signed release size and performance with the previous build.

## Common errors

| Symptom | Cause | Fix |
| --- | --- | --- |
| Duplicate classes or native symbols | Two SDK versions are packaged | Keep only one AAR, pod, or framework source |
| `INSTALL_FAILED_NO_MATCHING_ABIS` | The device or build does not include `arm64-v8a` | Test on a 64-bit ARM device and keep the required ABI in the app |
| Simulator linker error | The iOS framework is device-only | Select a physical iPhone or generic device archive target |
| Flutter Android compiles but fails at runtime | The host did not include the proprietary AAR | Add the verified `3.0.4` AAR once in the application module |

## Next steps

- [Install Android](/docs/effects/installation/android/)
- [Install iOS](/docs/effects/installation/ios/)
- [Install Flutter](/docs/effects/installation/flutter/)
- [Install React Native](/docs/effects/installation/react-native/)
- [Review platform support](/docs/effects/platform-support/)
- [Build a camera game](/docs/effects/concepts/camera-games/)

## References

- [Android releases](https://github.com/nosmai/nosmai_effects_sdk_android/releases)
- [iOS releases](https://github.com/nosmai/nosmai_effects_sdk_ios/releases)
- [Flutter releases](https://github.com/nosmai/nosmai_effects_sdk_flutter/releases)
- [React Native releases](https://github.com/nosmai/nosmai_effects_sdk_react_native/releases)
- [Flutter package](https://pub.dev/packages/nosmai_effects_sdk)
- [React Native package](https://www.npmjs.com/package/@nosmai/react-native-effects-sdk)
- [iOS CocoaPod](https://cocoapods.org/pods/NosmaiCameraSDK)