Skip to content

Release 2.3.0 #919

@reez

Description

@reez

Part 1: Bump BDK Rust Version

    • Open a PR with an update to Cargo.toml to the new bdk release candidate and ensure all CI workflows run correctly. Fix errors if necessary.
    • Once the new bdk release is out, update the PR to replace the release candidate with the full release and merge.

Test out generating bindings between 2.2.0 and 2.3.0 and diff them to spot breaking changes

Part 2: Prepare Libraries for Release Branch

Android

    • Delete the target directory in bdk-ffi and all build directories (in root and lib) in the bdk-android directory to make sure you're building the library from scratch.
    • Build the library and run the offline and live tests, and adjust them if necessary (note that you'll need an Android emulator running).
# start an emulator prior to running the tests
cd ./bdk-android/
just clean
just build
just test
    • Update the readme if necessary.

Swift

    • Delete the target directory in bdk-ffi.
    • Run all offline and live tests and adjust them if necessary.
cd ./bdk-swift/
just clean
just build
just test
    • Update the readme if necessary.

Part 3: Release Workflow

    • Update the Android and Swift libraries as per the Part 2 section above. Open a single PR on master for all of these changes called Prepare language bindings libraries for 0.X release. See example PR here.
    • Create a new branch off of master called release/<feature version>, e.g. release/1.2
    • Update bdk-android version from SNAPSHOT version to release version and open a PR to the release branch that updates the Android version. See example PR here.
    • Get a review and ACK and merge this PR on the release branch.
    • Create the tag for the release and make sure to add the changelog info to the tag (works better if you prepare the tag message on the side in a text editor). Push the tag to GitHub.
git tag v0.6.0 --sign --edit
git push upstream v0.6.0
    • Trigger manual releases for both libraries (for Swift, go to the bdk-swift repository and trigger the workflow using master. Simply add the version number and tag name in the text fields when running the workflow manually. Note that the version number must not contain the v, i.e. 0.26.0, but the tag will have it, i.e. v0.26.0). For Android, trigger the release workflow using the tag (not a branch).
    • Make sure the released libraries work and contain the artifacts you would expect.
    • Aggregate all the changelog notices from the PRs and add them to the changelog file. PR that.
    • Bump the version on master from 1.1.0-SNAPSHOT to 1.2.0-SNAPSHOT (Android) and 1.1.0-alpha.0 to 1.2.0-alpha.0 (Rust).
    • Apply changes to the release issue template if needed.
    • Make release on GitHub (generate auto release notes between the previous tag and the new one).
    • Build API docs for Android locally and PR the website to the bitcoindevkit.org repo.
    • Post in the announcement channel.
    • Tweet about the new release!

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    Status

    No status

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions