From b4164e5d08ad758a669c547e9d7d26456196e2e2 Mon Sep 17 00:00:00 2001 From: lizhongyi Date: Fri, 14 Jul 2023 19:57:08 +0800 Subject: [PATCH] docs: update uts-ios-cocoapods.md --- docs/plugin/uts-ios-cocoapods.md | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) diff --git a/docs/plugin/uts-ios-cocoapods.md b/docs/plugin/uts-ios-cocoapods.md index 04223e2a8..86b1afb3e 100644 --- a/docs/plugin/uts-ios-cocoapods.md +++ b/docs/plugin/uts-ios-cocoapods.md @@ -14,6 +14,15 @@ { "name": "WechatOpenSDK", "version": "2.0.2" + }, { + "name": "Alamofire", + "version": "5.7.3", //配置 repo 时可不指定 version + "repo": { // 可选，配置 pod 库为指定仓库，配置repo时，应至少指定 git + "git": "https://github.com/test/Alamofire.git", //指定 pod 库的仓库地址 + "tag": "5.7.3", // 指定该 pod 库仓库的 tag + "branch": "dev", // 指定该 pod 库仓库的分支 + "commit": "b309714f3aa5091f1ce8d932094b7594ed7acad9" // 指定该 pod 库仓库的某次commit + } }] } ``` @@ -23,8 +32,9 @@ + 插件支持的最低版本号应该设置为所有依赖的三方库（包含 framework .a pod ）中最低支持版本号中的最高的一个。 + pod 库的最低支持系统版本号可在 pod 库的 spec 文件或者 readme 中查看。 - 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"` 这种明确的数字版本号，不建议使用 `~>, >, >=, <, <=` 等带符号的配置。 + + 把需要依赖的 pod 库相关信息配置在 dependencies-pods 节点下，需要明确指定每个 pod 库的名字 (name) 按需要指定版本号 (version) 或者 (repo)，可同时配置多个 pod 依赖库。目前不支持通过 podfile 文件直接设置，也不支持 podfile 文件中除了 name 、 version 、pod 特定仓库之外的其他配置项。 + + 为了保证插件的稳定性，避免因未指定 pod 库版本，执行 pod install 之后 pod 库最新版本造成的代码不兼容问题，在未自定义 pod 库仓库地址时需要明确指定 pod 库的具体版本。version 字段不可省略，不可为空字符串。 建议将 version 配置为 `"9.7.0"` 这种明确的数字版本号，不建议使用 `~>, >, >=, <, <=` 等带符号的配置。 + + 如果你需要自己指定 pod 库的仓库地址，tag, branch, commit 等信息，可以通过repo字段配置，请注意，repo是一个对象，其中至少应包含 git 字段（用来指定 pod 库的仓库地址）。当你同时指定 tag、 branch、 commit 时，CocoaPods 会默认使用 commit，通常可以根据需要指定 tag / branch / commit 中的一个。 + 使用 CocoaPods 官方默认地址 (source 'https://cdn.cocoapods.org/'), 暂不接受 (source '私有库url') 等存放在私有域名下pod库。 -- GitLab