# @evrotrust/et-react-native-wl-sdk 中文文档 规范地址：https://npmcn.com/package/%40evrotrust/et-react-native-wl-sdk/ 版本：2\.0\.45 npm 元数据更新时间：2026-10-29T12:41:00.135Z 中文译文更新时间：2026-11-14T02:44:30.659Z 软件包许可：SEE LICENSE IN LICENSE 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40evrotrust/et-react-native-wl-sdk 原文对照：https://npmcn.com/package/%40evrotrust/et-react-native-wl-sdk/?lang=original 项目主页：https://evrotrust.com/ ## 关键信息（来自 npm 元数据） - 包体积（解压后）：22.7 MB，242 个文件 - 模块格式：ESM + CJS - TypeScript 类型：包内自带 - 运行依赖：1 个 - peer 依赖：react \*，react-native \* - 首次发布：2025-07-11T13:16:00.918Z - 最新版本发布：2026-10-29T12:40:59.445Z - 近 30 天下载量：2984（2026-10-14 至 2026-11-12，npm 官方下载统计） - 已发布版本数：34（近 12 个月 12 个） ## 中文简介 Evrotrust 反应原生 WL SDK ## 安装 ```sh npm install @evrotrust/et-react-native-wl-sdk ``` 也可以使用：`pnpm add @evrotrust/et-react-native-wl-sdk`、`yarn add @evrotrust/et-react-native-wl-sdk`、`bun add @evrotrust/et-react-native-wl-sdk` ## README # Evrotrust 反应原生 WL SDK ### 使用量 ```sh See the provided file Evrotrust SDK React Native 1.4.pdf ``` ### 包含 SDKs ```sh Android WL SDK - 1.1.8 iOS WL SDK - 1.1.1232 FaceTec SDK (Android & iOS) - 10.1.9 Regula DocumentReader - iOS 9.7.6818 (MRZRFID 9.7.19696) / Android 9.7.13216 (MRZRFID 9.7.16470) ``` ### 反应- 内设指令 1. 设置登记册 ```sh "npm config set registry https://registry.npmjs.org/" ``` 2. 创建新工作空间 ```sh "npx create-nx-workspace@21.0.0" Where would you like to create your workspace? - org Which stack do you want to use? - none: Configures a TypeScript/JavaScript monorepo. Would you like to use Prettier for code formatting? - no Which CI provider would you like to use? - skip Would you like remote caching to make your build faster? - skip ``` 3. 在新工作空间中输入 ```sh "cd org" ``` 4. 为 Nx 18+ 安装反应本地化 ```sh "npx nx add @nx/react-native" ``` 5. 生成反应- 内在: init ```sh "npx nx generate @nx/react-native:app myapp" ``` 6. 生成 @nx/ react-native:应用程序 ```sh Run 'pod install' for native modules? (Y/n) › true Which bundler do you want to use to build the application? - vite ``` 7. 在"org/myapp/package.json"中,添加了依赖性 ```sh before changes: { "name": "@org/myapp", "version": "0.0.1", "private": true, } after changes: { "name": "@org/myapp", "version": "0.0.1", "private": true, "dependencies": { "react": "19.1.1", "react-native": "0.82.0", "@react-native/metro-config": "^0.82.0", "react-native-svg": "*", "metro-config": "*" } } ``` 8. 在工程文件夹中输入 ```sh "cd myapp" ``` 9. 安装反应库 ```sh "npm i @evrotrust/et-react-native-wl-sdk@2.0.45" ``` ### Android 设置指令 10. 修改我的app/android/gradle.propertys,使其具有以下特性: 软件 ```sh - "android.enableJetifier=true" - "android.useAndroidX=true" - (Optional) increase memory "org.gradle.jvmargs=-Xmx4608m" ``` 11. 修改我的应用/和机器人/应用/构建.gradle,使其具有以下功能: ```sh allprojects { repositories { maven { url "https://maven.regulaforensics.com/RegulaDocumentReader" } google() mavenCentral() maven { url 'https://www.jitpack.io' } maven { name = "github" url = uri("https://maven.pkg.github.com/Evrotrust/maven") credentials { username System.getenv("EVROTRUST_MAVEN_USERNAME") password System.getenv("EVROTRUST_MAVEN_PASSWORD") } } } } ``` 12. 添加环境变量取决于您的操作系统 : ```agsl EVROTRUST_MAVEN_USERNAME=your_username EVROTRUST_MAVEN_PASSWORD=your_password ``` 13. 添加到我的应用/和机器人/应用/建设中的依赖性. gradle ```sh implementation 'com.evrotrust:evrotrust-wl-sdk:1.1.8' implementation 'com.evrotrust:facetec-sdk:10.1.9' ``` 14. (备选) 如果您收到未出错 ```sh "Unable to make progress running work. There are items queued for execution but none of them can be started" Add this to myapp/android/build.gradle gradle.startParameter.excludedTaskNames.addAll( gradle.startParameter.taskNames.findAll { it.contains("testClasses") } ) ``` 15. (备选) 如果你在换地后收到崩溃, 将此添加到我的app/android/app/src/main/AndroidManifest.xml中 ```sh android:configChanges="locale|layoutDirection" ``` 16. 运行工程 ```sh "npx nx run-android myapp" ``` ### iOS 设置指令 10. 在项目某处添加"regula.license"文件. 从"构建相"中的 Xcode > Copy Bundle Resources"添加"regula.license"文件. 11. 选择目标 - > 构建设置 - > 总是嵌入 Swift 标准库 - > set 是 12. 选择目标 - > 构建设置 - > 总是启用比特码 - > set NO 13. 打开工程 名称/ios/ project name likes/Info.plist ```sh Add in .plist file: - key NSCameraUsageDescription with some description - key NSMicrophoneUsageDescription with some description - key NFCReaderUsageDescription with some description - key com.apple.developer.nfc.readersession.iso7816.select-identifiers - an array with the following string elements: * A00000045645444C2D3031 * A0000002480300 * A0000002480200 * A0000002480100 * A000000167455349474E * E80704007F00070302 * A0000002471001 - key UIDesignRequiresCompatibility with Boolean YES (required to use the pre-iOS 26 design, since the SDK doesn't support the new design introduced in iOS 26) ``` 14. AFNetworking (4. 0.1) 与 SDK 作为预建动态捆绑 x框架和自动嵌入 `pod install` - 无需采取行动. (英语:EvrotrustSDK. 框架通过 `@rpath/AFNetworking.framework`,所以这个 必须是一个动态框架; 添加它作为源代码会打破 带有重复/静态链接错误的构建。 ) 15. 在 XCode 中添加 FaceTec.strings 作为本地化文件,用于英语(EN)、保加利亚语(BG)、德语(DE)、匈牙利语(HU)、阿尔巴尼亚语(SQ)、马其顿语(MK)、罗马尼亚语(RO)、意大利语(IT)和法语(FR) 16. 运行工程 ```sh "npx nx run-ios myapp" ``` ## 常见问题 ### @evrotrust/et-react-native-wl-sdk 是什么？ Evrotrust 反应原生 WL SDK ### 如何安装 @evrotrust/et-react-native-wl-sdk？ 在项目目录运行 npm install @evrotrust/et-react-native-wl-sdk，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\*）、react-native（\*）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。 ### @evrotrust/et-react-native-wl-sdk 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @evrotrust/et-react-native-wl-sdk 支持 ESM 还是 CommonJS？ 同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。 ### @evrotrust/et-react-native-wl-sdk 可以商用吗？ @evrotrust/et-react-native-wl-sdk 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。 ### @evrotrust/et-react-native-wl-sdk 的下载量有多少？ 根据 npm 官方下载统计，@evrotrust/et-react-native-wl-sdk 在 2026/10/14 – 2026/11/12 这 30 天内被下载 2,984 次，日均约 99 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @evrotrust/et-react-native-wl-sdk 还在维护吗？ 最新版本 2\.0\.45 发布于 2026/10/29（15 天前）；至今共发布 34 个版本，其中过去 12 个月发布了 12 个；首次发布于 2025/07/11。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。