GoogleUtilities

GoogleUtilities 为 Firebase 和其他 Google SDK 提供了一系列在 Apple 平台进行开发时可用的实用工具。

这些实用工具不直接支持非 Google 库的使用。

集成测试

以下说明适用于次要版本和补丁版本的更新。主版本需要定制化的适配。

CI 变为绿色后

通过检查已标记的版本确定下一个要发布的版本。确保下一个发布版本与 Swift PM 和 CocoaPods 版本保持同步。
验证发布版本是否为CHANGELOG.md中的最新条目，如果不是，请进行更新。
更新 podspec 中的版本，使其与CHANGELOG.md中的最新条目匹配。
检出 main 分支并确保它是最新的
```
git checkout main
git pull
```
添加 CocoaPods 标签 ({version} 将是podspec中的最新版本)
```
git tag CocoaPods-{version}
git push origin CocoaPods-{version}
```
将 podspec 推送到指定的仓库
- 如果此版本的 GoogleUtilities 计划在下一次 Firebase 发布**之前或同时**发布
  推送到 SpecsStaging
```
pod repo push --skip-tests --use-json staging GoogleUtilities.podspec
```
  如果命令失败并显示 Unable to find the 'staging' repo.，请使用以下命令添加 staging 仓库：
```
pod repo add staging git@github.com:firebase/SpecsStaging.git
```
- 否则
  推送到 SpecsDev
```
pod repo push --skip-tests --use-json dev GoogleUtilities.podspec
```
  如果命令失败并显示 Unable to find the 'dev' repo.，请使用以下命令添加 dev 仓库：
```
pod repo add dev git@github.com:firebase/SpecsDev.git
```
运行 Firebase CI，等待下一个 nightly 构建或添加一个修改 Gemfile 的 PR。
在 google3 上，使用以下命令运行 copybara。然后，在生成的 CL 上启动全局 TAP。根据需要进行修正。
```
third_party/firebase/ios/Releases/run_copy_bara.py --directory GoogleUtilities --branch main
```

发布

发布流程如下：

为 Swift PM 标记和发布
发布到 CocoaPods
创建 GitHub Release
执行发布后清理

Swift Package Manager

通过为 Swift PM 创建并推送标签，新标记的版本将立即发布以供公众使用。鉴于此，请验证 Swift PM 的预期发布时间。

为 Swift PM 添加版本标签

git tag {version}
git push origin {version}

注意：确保任何依赖于新的 GoogleUtilities 版本的进行中的 PR 都已更新为指向新标记的版本，而不是校验和。

CocoaPods

将新版本的 pod 发布到 CocoaPods

建议指向 staging 中的 GoogleUtilities.podspec 以确保发布正确的 spec。
```
pod trunk push ~/.cocoapods/repos/staging/GoogleUtilities/{version}/GoogleUtilities.podspec.json
```
注意：在某些情况下，可以使用 --skip-tests 标志执行 pod trunk push。在这样做之前，请与维护人员仔细确认。

如果以上命令记录显示：🚀 GoogleUtilities ({version}) successfully published，则表示 pod 推送成功。此外，CocoaPodsAtGoogle 共同创作的新提交，该提交发布新版本，应出现在 CocoaPods specs 仓库中。最后，最新版本应显示在 GoogleUtilities 的 CocoaPods 页面上。

创建 GitHub Release

使用最新版本更新发布模板的 Tag version 和 Release title 字段。此外，在发布的描述中引用发行说明。

有关示例，请参见此版本。

不要忘记执行发布后清理！

发布后清理

清理 SpecsStaging

pwd=$(pwd)
mkdir -p /tmp/release-cleanup && cd $_
git clone git@github.com:firebase/SpecsStaging.git
cd SpecsStaging/
git rm -rf GoogleUtilities/
git commit -m "Post publish cleanup"
git push origin master
rm -rf /tmp/release-cleanup
cd $pwd

开发

要在此仓库中进行开发，请确保您至少拥有以下软件：

Xcode 12.0（或更高版本）
CocoaPods 1.10.0（或更高版本）
CocoaPods generate

对于您要开发的 pod

pod gen GoogleUtilities.podspec --local-sources=./ --auto-open --platforms=ios

注意：如果 CocoaPods 缓存已过期，您可能需要在运行 pod gen 命令之前运行 pod repo update。

注意：将 --platforms 选项设置为 macos 或 tvos 以开发/测试这些平台。从 10.2 开始，Xcode 无法正确处理多平台 CocoaPods 工作区。

Catalyst 开发

pod gen GoogleUtilities.podspec --local-sources=./ --auto-open --platforms=ios
选中 App-iOS Build Settings 中的 Mac 框
在 Settings Signing & Capabilities 选项卡中对 App 进行签名
单击 Project Manager 中的 Pods
将签名添加到 iOS 主机应用和单元测试目标
选择 Unit-unit 方案
运行它以构建和测试

或者，在每个目标中禁用签名

转到 Build Settings 选项卡
点击 +
选择 Add User-Defined Setting
添加 CODE_SIGNING_REQUIRED 设置，值为 NO

代码格式化

为确保代码格式一致，请在创建 PR 之前运行脚本 ./scripts/check.sh。

GitHub Actions 将验证任何代码更改是否以符合样式的方式完成。安装 clang-format 和 mint

brew install clang-format@18
brew install mint

运行单元测试

选择一个 scheme 并按 Command-u 来构建一个组件并运行其单元测试。

贡献

请参阅贡献。

许可

本仓库的内容在 Apache License, version 2.0 许可下发布。