本地 SDK 版本自定义

⚠️ ⚠️ 高级配置 本节适用于需要使用特定版本 Rive 本地 SDK 的高级用户。在大多数情况下，您应该使用库自带的默认版本。只有在您有特定要求并理解潜在的兼容性影响时，才自定义这些版本。

重要： 如果您自定义了本地 SDK 版本，之后将 Rive React Native 升级到更新版本时，应重新检查您的自定义版本设置。您指定的自定义版本可能与更新的 Rive React Native 版本不兼容。请务必检查新版本中的默认版本并进行充分测试。

默认行为

默认情况下，Rive React Native 使用 package.json 中指定的本地 SDK 版本：

"runtimeVersions": {
  "ios": "6.12.0",
  "android": "10.4.5"
}

这些版本经过测试，已知与此版本的 Rive React Native 配合良好。

自定义版本

您可以使用平台特定的配置文件覆盖这些默认版本。

参见可用的本地 Rive Android 和 iOS 版本。

iOS（普通 React Native）

创建或编辑 ios/Podfile.properties.json：

{
  "RiveRuntimeIOSVersion": "6.24.0"
}

然后运行：

cd ios && pod install

Android（普通 React Native）

添加到 android/gradle.properties：

Rive_RiveRuntimeAndroidVersion=11.9.2

Expo 项目

对于 Expo 项目，在 app.config.ts 中使用 config plugins：

import { ExpoConfig, ConfigContext } from "expo/config";
import { withPodfileProperties } from "@expo/config-plugins";
import { withGradleProperties } from "@expo/config-plugins";

export default ({ config }: ConfigContext): ExpoConfig => ({
  ...config,
  plugins: [
    [
      withPodfileProperties,
      {
        RiveRuntimeIOSVersion: "6.24.0",
      },
    ],
    [
      withGradleProperties,
      {
        Rive_RiveRuntimeAndroidVersion: "11.9.2",
      },
    ],
  ],
});

版本解析优先级

库按以下顺序解析版本：

iOS：

1. ios/Podfile.properties.json → RiveRuntimeIOSVersion
2. package.json → runtimeVersions.ios（默认）

Android：

1. android/gradle.properties → Rive_RiveRuntimeAndroidVersion
2. package.json → runtimeVersions.android（默认）