Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
87 commits
Select commit Hold shift + click to select a range
ba77881
feat: experimental iOS Rive backend with synchronous API
mfazekas Feb 9, 2026
bc19a21
chore: move docs to .local/docs, remove from git
mfazekas Feb 9, 2026
23002ba
refactor: remove ExperimentalFileSource from legacy backend
mfazekas Feb 9, 2026
6dc7d5b
fix: restore whitespace in legacy files, remove fragile asset type gu…
mfazekas Feb 9, 2026
c224311
fix: share single Worker across all files, fix artboard property data…
mfazekas Feb 9, 2026
5ecb3bf
fix: wire up trigger property to experimental fire/stream API
mfazekas Feb 9, 2026
da8bfa3
fix: set fit after view setup to fix .layout mode on initial render
mfazekas Feb 11, 2026
2d408e5
test: add advanced data binding harness tests
mfazekas Feb 11, 2026
b3110b7
fix: guard negative index in legacy viewModelByIndex and createInstan…
mfazekas Feb 11, 2026
319199f
fix: correct trigger property listener task type signature
mfazekas Feb 11, 2026
8b95a88
fix: embed SPM RiveRuntime.framework via Podfile post_install hook
mfazekas Feb 11, 2026
7745c9f
refactor: split Android into legacy/experimental backend directories
mfazekas Feb 12, 2026
5d0e762
feat: implement Android experimental backend using new app.rive.* API
mfazekas Feb 12, 2026
bc76a6c
feat: implement Android experimental backend with CommandQueue API
mfazekas Feb 16, 2026
28d4024
feat: migrate getEnums() from sync to async (Promise)
mfazekas Feb 17, 2026
6310acc
fix: color property overflow and test tolerance for cross-platform di…
mfazekas Feb 17, 2026
65e15c6
feat: add backend property to RiveFileFactory for runtime detection
mfazekas Feb 17, 2026
f953326
feat: migrate viewModelByIndex, createInstanceByIndex, viewModel to a…
mfazekas Feb 17, 2026
7493780
fix: lint formatting in ViewModel spec and harness test
mfazekas Feb 17, 2026
38cef88
ci: add experimental runtime harness tests for iOS and Android
mfazekas Feb 18, 2026
5181704
ci: increase iOS experimental harness timeout to 90min for cold builds
mfazekas Feb 18, 2026
85f8faf
fix: handle throwing Worker() init in rive-ios 6.15.1
mfazekas Feb 18, 2026
8cef66e
fix: experimental iOS instance lookup and test guards
mfazekas Feb 19, 2026
340d70c
feat: add async APIs for RiveFile/ViewModel and fix experimental inst…
mfazekas Feb 19, 2026
de0c1ab
chore: upgrade rive-ios SPM to 6.15.2
mfazekas Feb 19, 2026
93d71b0
fix: only allow snakeLizard enum on android legacy backend
mfazekas Feb 19, 2026
0dfd14a
test: add useViewModelInstance e2e harness tests
mfazekas Feb 19, 2026
f5bc7b0
fix: implement color property get/listen and fix UInt32 crash on expe…
mfazekas Feb 26, 2026
dbdba80
feat(ios): decouple SPM from experimental runtime toggle
mfazekas Mar 11, 2026
f46a76d
fix: unify USE_RIVE_NEW_API flag, replace SPM with CocoaPods, fix exp…
mfazekas Mar 12, 2026
f368388
fix: skip autoPlay test on both experimental backends
mfazekas Mar 12, 2026
dd1ed61
fix: remove unused Platform import
mfazekas Mar 12, 2026
dcc87de
chore: update nitrogen generated files
mfazekas Mar 16, 2026
197be74
fix: use ArrayBuffer instead of ArrayBufferHolder in new HybridRiveFi…
mfazekas Mar 16, 2026
0ad2756
feat: add async versions of viewModelCount, artboardCount, artboardNames
mfazekas Mar 16, 2026
b33fc6a
feat: add async alternatives for ViewModel property value getters
mfazekas Mar 16, 2026
8d796d1
fix: add missing Promise import in experimental Android property file…
mfazekas Mar 16, 2026
feb04d1
ci: remove android style guide enforcement from ktlint
mfazekas Mar 17, 2026
4150f94
fix(kotlin): fix all ktlint violations and add lint:fix:kotlin script
mfazekas Mar 17, 2026
ed3089a
ci: fail lint-kotlin job on ktlint errors
mfazekas Mar 17, 2026
af54404
feat: add explicit type field to ResolvedReferencedAsset for asset lo…
mfazekas Mar 17, 2026
a65d18e
fix: format import in ReferencedAssets.ts to satisfy Prettier
mfazekas Mar 17, 2026
c6baac1
chore: re-run nitrogen to regenerate bridge code for RiveAssetType/ty…
mfazekas Mar 17, 2026
9dec084
fix: disable function-naming ktlint rule for Composable PascalCase fu…
mfazekas Mar 17, 2026
5fbbe53
fix: apply ktlint auto-format to ComposeTestActivity
mfazekas Mar 17, 2026
d436392
fix(ios): update ExperimentalAssetLoader to use typed RiveAssetType enum
mfazekas Mar 17, 2026
5850417
fix(android): update ExperimentalAssetLoader to use typed RiveAssetTy…
mfazekas Mar 17, 2026
8d0fc76
refactor: API cleanup — validate option, createBlankInstanceAsync ren…
mfazekas Mar 17, 2026
e4a405c
fix(ios): correct set(value:) argument label to match generated protocol
mfazekas Mar 17, 2026
24a20a2
fix(ios): createInstanceByIndex(Async) now respects the index
mfazekas Mar 18, 2026
52d7777
fix: remove createInstanceByIndexAsync, fix createInstanceByIndex on …
mfazekas Mar 18, 2026
7a20835
fix(ios): implement propertyCount and instanceCount using runtime APIs
mfazekas Mar 18, 2026
5dbb8c8
test: strengthen replaceViewModel assertion to verify actual replacement
mfazekas Mar 18, 2026
1f55df7
fix(ios): don't set instanceName to property path for nested VMIs
mfazekas Mar 18, 2026
eced349
fix(android): remove VM name heuristic, throw on unsupported ops for …
mfazekas Mar 23, 2026
df6eb95
fix: update Podfile.lock to RiveRuntime 6.17.0 from main
mfazekas Mar 23, 2026
5dbf1b7
chore: regenerate nitrogen bindings after rebase
mfazekas Mar 26, 2026
f966dba
fix: remove duplicate async methods in legacy files, make HybridRiveV…
mfazekas Mar 26, 2026
bdc1d32
fix: add missing createInstanceAsync to experimental backends
mfazekas Mar 26, 2026
fd1fd5a
fix: remove redundant createInstanceAsync, keep only createBlankInsta…
mfazekas Mar 26, 2026
29ecca9
fix: use yarn nitrogen (with postprocess), fix ktlint blank line
mfazekas Mar 26, 2026
14ebb75
chore: add Issue189 reproducer and nodefaultbouncing.riv from fix/and…
mfazekas Mar 26, 2026
84372f4
fix(ios-exp): skip auto-binding when artboard has no default ViewModel
mfazekas Mar 26, 2026
d58ce51
Fix "0x1 not found" error when artboard has no default ViewModel on A…
mfazekas Mar 26, 2026
5408112
fix: enable experimental API flag, await Worker init, update Podfile.…
mfazekas Mar 27, 2026
9d956d5
fix: update test harnesses for useViewModelInstance {instance, error}…
mfazekas Mar 27, 2026
34d275a
fix: ktlint spacing between declarations with comments
mfazekas Mar 27, 2026
054ad1b
test: skip Android experimental tests that need rive-android#443
mfazekas Mar 30, 2026
0547574
test: clarify skip reasons for Android experimental test guards
mfazekas Mar 30, 2026
5d4a35c
fix: clean up legacy files to match upstream, fix Issue159 error type
mfazekas Mar 30, 2026
6346b4c
fix: make legacy HybridViewModel identical to main
mfazekas Mar 31, 2026
b8b9d78
feat: make experimental runtime the default, legacy opt-in via USE_RI…
mfazekas Mar 31, 2026
33b2c4a
refactor: rename android/src/experimental to android/src/new to match…
mfazekas Mar 31, 2026
6ac0dd5
fix: add missing getPropertyCountAsync/getInstanceCountAsync to new b…
mfazekas Mar 31, 2026
e9ee276
chore: enable prerelease (beta) versioning for 0.5.0 release track
mfazekas Mar 31, 2026
e2bb152
fix(ios): add @MainActor to RiveReactNativeView, guard stale config t…
mfazekas Apr 8, 2026
9afc78e
fix(ios): make awaitViewReady reentrant, support multiple callers
mfazekas Apr 8, 2026
c888aa7
fix(android): use RuntimeException instead of Error for recoverable f…
mfazekas Apr 8, 2026
bb06d88
fix: log error instead of swallowing in createInstanceByName catch
mfazekas Apr 8, 2026
a708e08
fix(android): log warning when inferFromMagicBytes falls back to IMAG…
mfazekas Apr 8, 2026
a5a7f01
fix(ios): add MainActor.assumeIsolated for calls into @MainActor Rive…
mfazekas Apr 8, 2026
018e92c
fix(ios): port Xcode 26 ODR workaround from main into podspec
mfazekas Apr 8, 2026
a212ec7
fix(ios): add missing try to MainActor.assumeIsolated in afterUpdate
mfazekas Apr 8, 2026
5b09da0
fix(ios): use onMainSync instead of MainActor.assumeIsolated for JS-c…
mfazekas Apr 8, 2026
62c426b
fix(ios): make onMainSync provide @MainActor isolation, fix infinite …
mfazekas Apr 9, 2026
c31b359
fix(ios): use Result to propagate errors from onMainSync across dispa…
mfazekas Apr 9, 2026
f2e412a
Fix Fit.LAYOUT artboard oversized on Android
mfazekas Apr 10, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .editorconfig
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,9 @@ ktlint_standard_string-template-indent = disabled
ktlint_standard_backing-property-naming = disabled
ktlint_standard_no-consecutive-comments = disabled
ktlint_standard_no-empty-first-line-in-class-body = disabled
ktlint_standard_condition-wrapping = disabled
ktlint_standard_if-else-wrapping = disabled
ktlint_standard_function-naming = disabled

[nitrogen/generated/**/*.kt]
ktlint = disabled
197 changes: 196 additions & 1 deletion .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ jobs:
github_token: ${{ secrets.GITHUB_TOKEN }}
reporter: github-pr-review
ktlint_version: "1.5.0"
android: true
fail_on_error: true

lint:
runs-on: ubuntu-latest
Expand Down Expand Up @@ -472,3 +472,198 @@ jobs:
run: |
echo "=== Checking logcat for errors ==="
adb logcat -d -s ReactNativeJS:* RiveExample:* RNRive:* | tail -200 || echo "No logs found"

test-harness-ios-legacy:
runs-on: macos-latest
timeout-minutes: 90
env:
XCODE_VERSION: 16.4
steps:
- name: Checkout
uses: actions/checkout@v4

- name: Setup
uses: ./.github/actions/setup

- name: Use appropriate Xcode version
uses: maxim-lobanov/setup-xcode@v1
with:
xcode-version: ${{ env.XCODE_VERSION }}

- name: Restore cocoapods
id: cocoapods-cache
uses: actions/cache/restore@v4
with:
path: |
**/ios/Pods
key: ${{ runner.os }}-legacy-cocoapods-${{ hashFiles('example/ios/Podfile', '*.podspec') }}
restore-keys: |
${{ runner.os }}-legacy-cocoapods-

- name: Install cocoapods
if: steps.cocoapods-cache.outputs.cache-hit != 'true'
run: |
cd example
bundle install
USE_RIVE_LEGACY=1 bundle exec pod install --project-directory=ios

- name: Save cocoapods cache
if: steps.cocoapods-cache.outputs.cache-hit != 'true'
uses: actions/cache/save@v4
with:
path: |
**/ios/Pods
key: ${{ steps.cocoapods-cache.outputs.cache-key }}

- name: Restore iOS build cache
id: ios-build-cache
uses: actions/cache/restore@v4
with:
path: example/ios/build
key: ${{ runner.os }}-ios-legacy-build-${{ env.XCODE_VERSION }}-${{ hashFiles('yarn.lock', 'ios/**', 'nitrogen/generated/ios/**', '*.podspec', 'example/ios/Podfile', 'example/ios/RiveExample/**') }}
restore-keys: |
${{ runner.os }}-ios-legacy-build-${{ env.XCODE_VERSION }}-

- name: Build iOS app
if: steps.ios-build-cache.outputs.cache-hit != 'true'
working-directory: example/ios
run: |
set -o pipefail && xcodebuild \
-derivedDataPath build \
-workspace RiveExample.xcworkspace \
-scheme RiveExample \
-sdk iphonesimulator \
-configuration Debug \
build \
CODE_SIGNING_ALLOWED=NO

- name: Save iOS build cache
if: steps.ios-build-cache.outputs.cache-hit != 'true'
uses: actions/cache/save@v4
with:
path: example/ios/build
key: ${{ steps.ios-build-cache.outputs.cache-primary-key }}

- name: Boot iOS Simulator
uses: futureware-tech/simulator-action@v4
with:
model: 'iPhone 16 Pro'
os_version: '18.6'

- name: Install app on simulator
run: xcrun simctl install booted example/ios/build/Build/Products/Debug-iphonesimulator/RiveExample.app

- name: Wait for simulator to be fully ready
run: |
echo "Waiting for simulator to be fully ready..."
sleep 10
xcrun simctl list devices | grep Booted

- name: Run harness tests on iOS
working-directory: example
run: |
for attempt in 1 2 3; do
echo "Attempt $attempt of 3"
if yarn test:harness:ios --verbose --testTimeout 120000; then
echo "Tests passed on attempt $attempt"
exit 0
fi
echo "Attempt $attempt failed, retrying..."
sleep 5
done
echo "All attempts failed"
exit 1

- name: Debug - Check for console logs
if: failure()
run: |
echo "=== Checking simulator logs for errors ==="
xcrun simctl spawn booted log show --predicate 'processImagePath CONTAINS "RiveExample"' --last 5m --style compact 2>&1 | tail -200 || echo "No logs found"

test-harness-android-legacy:
runs-on: ubuntu-latest
timeout-minutes: 30
env:
ANDROID_API_LEVEL: 35
steps:
- name: Checkout
uses: actions/checkout@v4

- name: Setup
uses: ./.github/actions/setup

- name: Install JDK
uses: actions/setup-java@v4
with:
distribution: 'zulu'
java-version: '17'

- name: Finalize Android SDK
run: |
/bin/bash -c "yes | $ANDROID_HOME/cmdline-tools/latest/bin/sdkmanager --licenses > /dev/null"

- name: Enable legacy Rive backend
run: |
echo "USE_RIVE_LEGACY=true" >> example/android/gradle.properties

- name: Cache Gradle
uses: actions/cache@v4
with:
path: |
~/.gradle/wrapper
~/.gradle/caches
key: ${{ runner.os }}-gradle-harness-legacy-${{ hashFiles('example/android/gradle/wrapper/gradle-wrapper.properties') }}
restore-keys: |
${{ runner.os }}-gradle-harness-legacy-
${{ runner.os }}-gradle-harness-
${{ runner.os }}-gradle-

- name: Restore Android build cache
id: android-build-cache
uses: actions/cache/restore@v4
with:
path: example/android/app/build
key: ${{ runner.os }}-android-legacy-build-${{ env.ANDROID_API_LEVEL }}-${{ hashFiles('yarn.lock', 'android/**', 'nitrogen/generated/android/**', 'example/android/app/build.gradle', 'example/android/gradle.properties') }}
restore-keys: |
${{ runner.os }}-android-legacy-build-${{ env.ANDROID_API_LEVEL }}-

- name: Build Android app
if: steps.android-build-cache.outputs.cache-hit != 'true'
working-directory: example/android
env:
JAVA_OPTS: "-XX:MaxHeapSize=6g"
run: |
./gradlew assembleDebug --no-daemon --console=plain -PreactNativeArchitectures=x86_64

- name: Save Android build cache
if: steps.android-build-cache.outputs.cache-hit != 'true'
uses: actions/cache/save@v4
with:
path: example/android/app/build
key: ${{ steps.android-build-cache.outputs.cache-primary-key }}

- name: Enable KVM
run: |
echo 'KERNEL=="kvm", GROUP="kvm", MODE="0666", OPTIONS+="static_node=kvm"' | sudo tee /etc/udev/rules.d/99-kvm4all.rules
sudo udevadm control --reload-rules
sudo udevadm trigger --name-match=kvm

- name: Run harness tests on Android
uses: reactivecircus/android-emulator-runner@v2
with:
api-level: ${{ env.ANDROID_API_LEVEL }}
arch: x86_64
target: google_apis
force-avd-creation: false
emulator-options: -no-snapshot-save -no-window -gpu swiftshader_indirect -noaudio -no-boot-anim
disable-animations: true
script: |
adb install example/android/app/build/outputs/apk/debug/app-debug.apk
sleep 10
cd example && for attempt in 1 2 3; do echo "Attempt $attempt of 3"; if timeout 300 env ANDROID_AVD=test yarn test:harness:android --verbose --testTimeout 120000; then echo "Tests passed on attempt $attempt"; exit 0; fi; echo "Attempt $attempt failed (exit $?), retrying..."; sleep 5; done; echo "All attempts failed"; exit 1

- name: Debug - Check logcat
if: failure() || cancelled()
run: |
echo "=== Checking logcat for errors ==="
adb logcat -d -s ReactNativeJS:* RiveExample:* RNRive:* | tail -200 || echo "No logs found"
22 changes: 20 additions & 2 deletions RNRive.podspec
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,15 @@ if !rive_ios_version
raise "Internal Error: Failed to determine Rive iOS SDK version. Please ensure package.json contains 'runtimeVersions.ios'"
end

Pod::UI.puts "@rive-app/react-native: Rive iOS SDK #{rive_ios_version}"
# The experimental runtime backend is used by default. Set USE_RIVE_LEGACY=1
# (or $UseRiveLegacy = true in Podfile) to fall back to the legacy backend.
use_legacy = ENV['USE_RIVE_LEGACY'] == '1' || (defined?($UseRiveLegacy) && $UseRiveLegacy)

if use_legacy
Pod::UI.puts "@rive-app/react-native: Using legacy Rive runtime backend (iOS SDK #{rive_ios_version})"
else
Pod::UI.puts "@rive-app/react-native: Using experimental Rive runtime backend"
end

# Xcode 26 workaround: strip .Swift Clang submodule from RiveRuntime's prebuilt
# modulemaps to prevent ODR conflicts with locally-compiled Swift C++ interop.
Expand Down Expand Up @@ -65,11 +73,21 @@ Pod::Spec.new do |s|

s.source_files = "ios/**/*.{h,m,mm,swift}"

if use_legacy
s.exclude_files = ["ios/new/**"]
else
s.exclude_files = ["ios/legacy/**"]
end

s.public_header_files = ['ios/RCTSwiftLog.h']
load 'nitrogen/generated/ios/RNRive+autolinking.rb'
add_nitrogen_files(s)

s.dependency "RiveRuntime", rive_ios_version
s.dependency 'RiveRuntime', rive_ios_version

install_modules_dependencies(s)

unless use_legacy
s.xcconfig = { 'OTHER_SWIFT_FLAGS' => '$(inherited) -DRIVE_EXPERIMENTAL_API' }
end
end
7 changes: 7 additions & 0 deletions android/build.gradle
Original file line number Diff line number Diff line change
Expand Up @@ -111,10 +111,17 @@ android {
targetCompatibility JavaVersion.VERSION_1_8
}

def useLegacy = rootProject.findProperty('USE_RIVE_LEGACY') == 'true'

sourceSets {
main {
java.srcDirs += ["generated/java",
"generated/jni"]
if (useLegacy) {
java.srcDirs += ["src/legacy/java"]
} else {
java.srcDirs += ["src/new/java"]
}
}
}
}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -138,6 +138,23 @@ class HybridRiveFile : HybridRiveFileSpec() {
}
}

override fun getEnums(): Promise<Array<RiveEnumDefinition>> {
val file = riveFile ?: return Promise.resolved(emptyArray())
return Promise.async {
try {
file.enums
.map { enum ->
RiveEnumDefinition(
name = enum.name,
values = enum.values.toTypedArray()
)
}.toTypedArray()
} catch (e: NoSuchMethodError) {
throw UnsupportedOperationException("getEnums requires rive-android SDK with enums support")
}
}
}

override fun dispose() {
scope.cancel()
weakViews.clear()
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,8 @@ data class FileAndCache(
@Keep
@DoNotStrip
class HybridRiveFileFactory : HybridRiveFileFactorySpec() {
override val backend: String = "legacy"

private fun buildRiveFile(
data: ByteArray,
referencedAssets: ReferencedAssetsType?
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -102,6 +102,10 @@ class RiveReactNativeView(context: ThemedReactContext) : FrameLayout(context) {
}

fun configure(config: ViewConfiguration, dataBindingChanged: Boolean, reload: Boolean = false, initialUpdate: Boolean = false) {
// https://github.com/rive-app/rive-nitro-react-native/pull/209
riveAnimationView?.layoutScaleFactor = config.layoutScaleFactor
?: resources.displayMetrics.density

if (reload) {
val hasDataBinding = when (config.bindData) {
is BindData.None -> false
Expand All @@ -121,8 +125,6 @@ class RiveReactNativeView(context: ThemedReactContext) : FrameLayout(context) {
} else {
riveAnimationView?.alignment = config.alignment
riveAnimationView?.fit = config.fit
// TODO: this seems to require a reload for the view to take the new value (bug on Android)
riveAnimationView?.layoutScaleFactor = config.layoutScaleFactor
}

if (dataBindingChanged || initialUpdate || reload) {
Expand Down
Loading
Loading