firebase-ios-sdk/scripts/create_spec_repo/README.md

Podspec presubmit test setup

Podspec presubmit test is to help ensure podspec is releasable. 'pod spec lint' will run for SDKs with sources of

• https://github.com/firebase/SpecsTesting
• https://github.com/firebase/SpecsDev.git
• https://github.com/firebase/SpecsStaging.git
• https://cdn.cocoapods.org/

where SpecsTesting is generated from the head of the master branch of firebase-ios-sdk repo.

The prerelease workflow will update the SpecsTesting repo nightly from the head of the master branch. In order to let presubmit tests run on the latest podspec repo, SpecsTesting repo will be updated when a PR with changed podspecs is merged. When this PR is merged, changed podspecs will be pod repo pushed to the podspec repo in postsubmit tests.

Since pod spec lint will test podspecs with remote sources. One PR with changes on multiple podspecs are not encouraged. Changes with multiple podspecs, including their dependencies, might fail presubmit tests.

Set up presubmit tests

To set up presubmit tests, we can add a new job in SDK workflows. An example of FirebaseDatabase is shown below. github.event.pull_request.merged != true && github.event.action != 'closed' is to trigger this job in presubmit.

  podspec-presubmit:
    # Don't run on private repo unless it is a PR.
    if: github.repository == 'Firebase/firebase-ios-sdk' && github.event.pull_request.merged != true && github.event.action != 'closed'
    runs-on: macOS-latest
    steps:
    - uses: actions/checkout@v2
    - name: Setup Bundler
      run: scripts/setup_bundler.sh
    - name: Build and test
      run: scripts/third_party/travis/retry.sh pod spec lint FirebaseDatabase.podspec --skip-tests --sources='https://github.com/firebase/SpecsTesting','https://github.com/firebase/SpecsDev.git','https://github.com/firebase/SpecsStaging.git','https://cdn.cocoapods.org/'

Once a PR is merged, update_SpecsTesting_repo job in the prerelease workflow will automatically pod repo push changed podspecs in postsubmits,