diff --git a/docs/plugin/uts-ios-cocoapods.md b/docs/plugin/uts-ios-cocoapods.md index 414d8d59d52f6d7d63d31b9326a978cfa0f35067..93e25ff067d764c8a59b541f883be33e37e976ae 100644 --- a/docs/plugin/uts-ios-cocoapods.md +++ b/docs/plugin/uts-ios-cocoapods.md @@ -192,6 +192,7 @@ pod search Alamofire ``` 说明:出现此错误是因为执行 pod install 时找不到指定依赖。 + 处理方法: - 请首先确保配置的 pod 库 name 正确,配置的 version 不高于 pod 库发行的最高版本号。 @@ -212,6 +213,7 @@ pod search Alamofire ``` 说明: 出现此错误是因为当前网络无法正常访问 github + 处理方法: - 请检查您的网络连接,或者使用翻墙工具,确保当前网络环境可以正常访问 github diff --git a/docs/plugin/uts-ios-config.md b/docs/plugin/uts-ios-config.md deleted file mode 100644 index 48f541f54c9c2cdc02f5a7448d0e19b9487911da..0000000000000000000000000000000000000000 --- a/docs/plugin/uts-ios-config.md +++ /dev/null @@ -1,31 +0,0 @@ -##### config.json -uts插件在iOS平台的其它原生配置文件,可以在其中配置依赖的系统库等信息 - -```json -{ - "frameworks": [ - "可选,依赖的系统库(系统库有.framework和.tbd和.dylib类型)" - ], - "deploymentTarget": "9.0", // 可选,插件支持的最低 iOS 版本 默认:9.0" - "validArchitectures": [ // 可选,支持的 CPU 架构类型 默认:arm64 - "arm64" - ], - "dependencies-pods": [ // 可选, 需要依赖的pod库, HBuilder X 3.8.5+ 版本支持 - { - "name": "WechatOpenSDK", - "version": "2.0.2" - }] -} -``` - -**配置说明:** -- frameworks:插件需要依赖的系统库(系统库有 .framework 和 .tbd 和 .dylib 类型),此节点为可选项。 -- deploymentTarget:插件支持的最低 iOS 版本号,此节点为可选项,默认设置为 9.0. - + 插件支持的最低版本号应该设置为所有依赖的三方库(包含 framework .a pod )中最低支持版本号中的最高的一个。 - + pod 库的最低支持系统版本号可在 pod 库的 spec 文件或者 readme 中查看。 -- validArchitectures:插件支持的 CPU 架构类型,此节点为可选项,默认值为:arm64。 -- dependencies-pods:插件需要依赖的 pod 库, HBuilder X 3.8.5+ 版本支持 - + 把需要依赖的 pod 库相关信息配置在 dependencies-pods 节点下,需要明确指定每个 pod 库的名字 (name) 和版本号 (version),可同时配置多个 pod 依赖库。目前不支持通过 podfile 文件直接设置,也不支持 podfile 文件中除了 name 和 version 之外的其他配置项。 - + 为了保证插件的稳定性,避免因未指定 pod 库版本,执行 pod install 之后 pod 库最新版本造成的代码不兼容问题,需要明确指定 pod 库的具体版本。version 字段不可省略,不可为空字符串。 建议将 version 配置为 `"9.7.0"` 这种明确的数字版本号,不建议使用 `~>, >, >=, <, <=` 等带符号的配置。 - + 使用 CocoaPods 官方默认地址 (source 'https://cdn.cocoapods.org/'), 暂不接受 (source '私有库url') 等存放在私有域名下pod库。 - + 有关 CocoaPods 使用过程中常见的错误和处理方式[详见](https://uniapp.dcloud.net.cn/plugin/uts-ios-cocoapods.html) \ No newline at end of file diff --git a/docs/plugin/uts-plugin.md b/docs/plugin/uts-plugin.md index 4b467e913d2b3644dad28650c5f3818b163920b8..9bfeea47ea03988fb95baff893f0ce213a999e8d 100644 --- a/docs/plugin/uts-plugin.md +++ b/docs/plugin/uts-plugin.md @@ -367,15 +367,28 @@ uts插件在iOS平台的其它原生配置文件,可以在其中配置依赖 "可选,依赖的系统库(系统库有.framework和.tbd和.dylib类型)" ], "deploymentTarget": "9.0", // 可选,插件支持的最低 iOS 版本 默认:9.0" - "validArchitectures": [ // 可选,支持的 CPU 架构类型 默认:armv7、arm64 - "arm64" // 支持多个值,可取值:"arm64", "armv7" - ] + "validArchitectures": [ // 可选,支持的 CPU 架构类型 默认:arm64 + "arm64" + ], + "dependencies-pods": [ // 可选, 需要依赖的pod库, HBuilderX 3.8.5+ 版本支持 + { + "name": "WechatOpenSDK", + "version": "2.0.2" + }] } ``` -**注意:** - -- iOS 平台 uts 原生插件需提交云端打包才能生效,真机运行时需使用[自定义基座](https://uniapp.dcloud.net.cn/tutorial/run/run-app.html#customplayground) +**配置说明:** +- frameworks:插件需要依赖的系统库(系统库有 .framework 和 .tbd 和 .dylib 类型),此节点为可选项。 +- deploymentTarget:插件支持的最低 iOS 版本号,此节点为可选项,默认设置为 9.0. + + 插件支持的最低版本号应该设置为所有依赖的三方库(包含 framework .a pod )中最低支持版本号中的最高的一个。 + + pod 库的最低支持系统版本号可在 pod 库的 spec 文件或者 readme 中查看。 +- validArchitectures:插件支持的 CPU 架构类型,此节点为可选项,默认值为:arm64。 +- dependencies-pods:插件需要依赖的 pod 库, HBuilderX3.8.5+ 版本新增支持 + + 把需要依赖的 pod 库相关信息配置在 dependencies-pods 节点下,需要明确指定每个 pod 库的名字 (name) 和版本号 (version),可同时配置多个 pod 依赖库。目前不支持通过 podfile 文件直接设置,也不支持 podfile 文件中除了 name 和 version 之外的其他配置项。 + + 为了保证插件的稳定性,避免因未指定 pod 库版本,执行 pod install 之后 pod 库最新版本造成的代码不兼容问题,需要明确指定 pod 库的具体版本。version 字段不可省略,不可为空字符串。 建议将 version 配置为 `"9.7.0"` 这种明确的数字版本号,不建议使用 `~>, >, >=, <, <=` 等带符号的配置。 + + 使用 CocoaPods 官方默认地址 (source 'https://cdn.cocoapods.org/'), 暂不接受 (source '私有库url') 等存放在私有域名下pod库。 + + 有关 CocoaPods 使用过程中常见的错误和处理方式[详见](https://uniapp.dcloud.net.cn/plugin/uts-ios-cocoapods.html) ## 3 开发uts插件