You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: .github/ISSUE_TEMPLATE/release.md
+24-23Lines changed: 24 additions & 23 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,58 +8,59 @@ assignees: ""
8
8
9
9
## Part 1: Bump BDK Rust Version
10
10
11
-
1.-[ ] 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.
12
-
2.-[ ] Once the new bdk release is out, update the PR to replace the release candidate with the full release and merge.
11
+
-[ ] 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.
12
+
-[ ] Once the new bdk release is out, update the PR to replace the release candidate with the full release and merge.
13
13
14
14
## Part 2: Prepare Libraries for Release Branch
15
15
16
16
### _Android_
17
17
18
-
3.-[ ] 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.
19
-
4.-[ ] Build the library and run the offline and live tests, and adjust them if necessary (note that you'll need an Android emulator running).
18
+
-[ ] 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.
19
+
-[ ] Build the library and run the offline and live tests, and adjust them if necessary (note that you'll need an Android emulator running).
20
20
```shell
21
21
# start an emulator prior to running the tests
22
22
cd ./bdk-android/
23
23
just clean
24
24
just build
25
25
just test
26
26
```
27
-
5.-[ ] Update the readme if necessary.
27
+
-[ ] Update the readme if necessary.
28
28
29
29
### _Swift_
30
30
31
-
6.-[ ] Delete the `target` directory in bdk-ffi.
32
-
7.-[ ] Run all offline and live tests and adjust them if necessary.
31
+
-[ ] Delete the `target` directory in bdk-ffi.
32
+
-[ ] Run all offline and live tests and adjust them if necessary.
33
33
```shell
34
34
cd ./bdk-swift/
35
35
just clean
36
36
just build
37
37
just test
38
38
```
39
-
8.-[ ] Update the readme if necessary.
39
+
-[ ] Update the readme if necessary.
40
40
41
41
## Part 3: Release Workflow
42
42
43
-
9.-[ ] 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](https://github.com/bitcoindevkit/bdk-ffi/pull/315).
44
-
10.-[ ] Create a new branch off of `master` called `release/<feature version>`, e.g. `release/1.2`
45
-
11.-[ ] Generate release notes with GitHub's built-in release note generator, using the previous release tag as the previous tag and the release branch as the target. Review the generated notes and prepare the final changelog text on the side in a text editor.
46
-
12.-[ ] Update the bdk-android version from a `SNAPSHOT` version to a release version (`2.4.0-SNAPSHOT` -> `2.4.0`), update the Rust library version in `Cargo.toml` from an alpha to a release version (`2.4.0-alpha.0` -> `2.4.0`), add the reviewed release notes to the changelog file, and open a PR to the release branch with these changes.
47
-
13.-[ ] Get a review and ACK and merge this PR on the release branch.
48
-
14.-[ ] Create the tag for the release and make sure to add the reviewed changelog info to the tag. Push the tag to GitHub.
43
+
-[ ] 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](https://github.com/bitcoindevkit/bdk-ffi/pull/315).
44
+
-[ ] Create a new branch off of `master` called `release/<feature version>`, e.g. `release/1.2`
45
+
-[ ] Generate release notes with GitHub's built-in release note generator, using the previous release tag as the previous tag and the release branch as the target. Review the generated notes and prepare the final changelog text on the side in a text editor.
46
+
-[ ] Update the bdk-android version from a `SNAPSHOT` version to a release version (`2.4.0-SNAPSHOT` -> `2.4.0`), update the Rust library version in `Cargo.toml` from an alpha to a release version (`2.4.0-alpha.0` -> `2.4.0`), add the reviewed release notes to the changelog file, and open a PR to the release branch with these changes.
47
+
-[ ] Get a review and ACK and merge this PR on the release branch.
48
+
-[ ] Create the tag for the release and make sure to add the reviewed changelog info to the tag. Push the tag to GitHub.
49
49
```shell
50
50
git tag v0.6.0 --sign --edit
51
51
git push upstream v0.6.0
52
52
```
53
-
15.-[ ] Trigger manual releases for both libraries (for Swift, go to the [bdk-swift](https://github.com/bitcoindevkit/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).
54
-
16.-[ ] Make sure the released libraries work and contain the artifacts you would expect.
55
-
17.-[ ] Build the Rust API docs and publish them to the repo's GitHub Pages.
53
+
-[ ] Update all downstream libraries (dart, rn, python, and jvm) to the given tag. This allows for everyone to test their own workflows, run their CI, etc.
54
+
-[ ] Trigger releases for both libraries (for Swift, go to the [bdk-swift](https://github.com/bitcoindevkit/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 locally.
55
+
-[ ] Make sure the released libraries work and contain the artifacts you would expect.
56
+
-[ ] Build the Rust API docs and publish them to the repo's GitHub Pages.
56
57
```shell
57
58
cd bdk-ffi/
58
59
just docs
59
60
```
60
-
18.-[ ] 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).
61
-
19.-[ ] Apply changes to the release issue template if needed.
62
-
20.-[ ] Make release on GitHub using the reviewed release notes.
63
-
21.-[ ] Build API docs for Android locally and PR the website to the bitcoindevkit.org repo.
64
-
22.-[ ] Post in the announcement channel.
65
-
23.-[ ] Tweet about the new release!
61
+
-[ ] 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).
62
+
-[ ] Apply changes to the release issue template if needed.
63
+
-[ ] Make release on GitHub using the reviewed release notes.
64
+
-[ ] Build API docs for Android locally and PR the website to the bitcoindevkit.org repo.
0 commit comments