开源软件名称（OpenSource Name）：

开源软件地址(OpenSource Url)：

开源编程语言(OpenSource Language)：

开源软件介绍(OpenSource Introduction)：

GoogleUtilities

GoogleUtilities provides a set of utilities for Firebase and other Google SDKs for Apple platform development.

The utilities are not directly supported for non-Google library usage.

Integration Testing

These instructions apply to minor and patch version updates. Major versions need a customized adaptation.

After the CI is green:

• Determine the next version for release by checking the tagged releases. Ensure that the next release version keeps the Swift PM and CocoaPods versions in sync.
• Verify that the releasing version is the latest entry in the CHANGELOG.md, updating it if necessary.
• Update the version in the podspec to match the latest entry in the CHANGELOG.md
• Checkout the main branch and ensure it is up to date

  git checkout main
  git pull

• Add the CocoaPods tag ({version} will be the latest version in the podspec)

  git tag CocoaPods-{version}
  git push origin CocoaPods-{version}

• Push the podspec to the designated repo

  • If this version of GoogleUtilities is intended to launch before or with the next Firebase release:

    Push to SpecsStaging

    pod repo push --skip-tests staging GoogleUtilities.podspec

    If the command fails with Unable to find the 'staging' repo., add the staging repo with:

    pod repo add staging [email protected]:firebase/SpecsStaging.git

  • Otherwise:

    Push to SpecsDev

    pod repo push --skip-tests dev GoogleUtilities.podspec

    If the command fails with Unable to find the 'dev' repo., add the dev repo with:

    pod repo add dev [email protected]:firebase/SpecsDev.git

• Run Firebase CI by waiting until next nightly or adding a PR that touches Gemfile.
• On google3, run copybara using the command below. Then, start a global TAP on the generated CL. Deflake as needed.

  third_party/firebase/ios/Releases/run_copy_bara.py --directory GoogleUtilities --branch main

Publishing

The release process is as follows:

1. Tag and release for Swift PM
2. Publish to CocoaPods
3. Create GitHub Release
4. Perform post release cleanup

Swift Package Manager

By creating and pushing a tag for Swift PM, the newly tagged version will be immediately released for public use. Given this, please verify the intended time of release for Swift PM.

• Add a version tag for Swift PM

git tag {version}
git push origin {version}

Note: Ensure that any inflight PRs that depend on the new GoogleUtilities version are updated to point to the newly tagged version rather than a checksum.

CocoaPods

• Publish the newly versioned pod to CocoaPods

  It's recommended to point to the GoogleUtilities.podspec in staging to make sure the correct spec is being published.

  pod trunk push ~/.cocoapods/repos/staging/GoogleUtilities/{version}/GoogleUtilities.podspec

  Note: In some cases, it may be acceptable to pod trunk push with the --skip-tests flag. Please double check with the maintainers before doing so.

  The pod push was successful if the above command logs: