Skip to content

Latest commit

 

History

History
79 lines (52 loc) · 2.17 KB

RELEASING.md

File metadata and controls

79 lines (52 loc) · 2.17 KB

How to update to newer OpenSSL version, build, and publish a release.

  1. Clone this repository.

    git clone https://github.com/cossacklabs/openssl-apple

    Make sure you're on the cossacklabs branch.

  2. Update OpenSSL version.

    The version number is in the Makefile.

    Increment PACKAGE_VERSION if you are repackaging the same OpenSSL version. Otherwise, update VERSION to OpenSSL version and reset PACKAGE_VERSION to 1.

    Also update tarball checksums in build-libssl.sh.

  3. Update platform configuration.

    Things like minimum OS SDK versions, architectures, etc. You can find all this in the Makefile.

  4. Build OpenSSL.

    make

    This can take a while. Not only it builds the library, this also packages it, and updates the project specs.

  5. Commit, tag, push the release.

    git add carthage
git commit -S -e -m "OpenSSL 1.1.1g"
git tag -s -e -m "OpenSSL 1.1.1g" v1.1.10701
git push origin cossacklabs # Push the branch
git push origin v1.1.10701  # Push the tag

    Make will remind you how to do this. (Use the correct versions there.) Take care to make signed commits and tags, this is important for vanity.

    Congratulations! You have just published a broken Carthage package.

  6. Publish GitHub release with binary framework files.

    Go to GitHub release page for the tag:

    https://github.com/cossacklabs/openssl-apple/releases/tag/v1.1.107

    press Edit tag and upload *.zip packages from output directory.

    Also, describe the release, press the Publish release when done.

    Congratulations! You should have fixed the Carthage package with this.

  7. Publish podspec.

    pod trunk push cocoapods/CLOpenSSL.podspec

    This lints the podspec before publishing it. If it does not lint then curse at CocoaPods and scrub the release.

    Congratulations! You have published a CocoaPods package.

Actually, you have published all of the OpenSSL. Now is the time to go check if it actually works. You can use Themis for that.