|
| 1 | +# v0.22.0 — Release assets (manifest) |
| 2 | + |
| 3 | +Binaries are **not** stored in this git repository; they are attached to the [GitHub Release for `v0.22.0`](https://github.com/OpenKnots/okcode/releases/tag/v0.22.0) by the [coordinated release workflow](../../.github/workflows/release.yml). |
| 4 | + |
| 5 | +The GitHub Release also includes **documentation attachments** with stable filenames: |
| 6 | + |
| 7 | +| File | Source in repo | |
| 8 | +| --------------------------- | ------------------------------------- | |
| 9 | +| `okcode-CHANGELOG.md` | [CHANGELOG.md](../../../CHANGELOG.md) | |
| 10 | +| `okcode-RELEASE-NOTES.md` | [v0.22.0.md](../v0.22.0.md) | |
| 11 | +| `okcode-ASSETS-MANIFEST.md` | This file | |
| 12 | + |
| 13 | +After the workflow completes, the release should contain the coordinated desktop outputs below. Filenames may include the product name `OK Code` and the version string `0.22.0`. |
| 14 | + |
| 15 | +## Desktop installers and payloads |
| 16 | + |
| 17 | +| Platform | Kind | Expected attachment pattern | |
| 18 | +| ------------------- | -------------- | --------------------------- | |
| 19 | +| macOS Apple Silicon | DMG (signed) | `*.dmg` (arm64) | |
| 20 | +| macOS | ZIP (updater) | `*.zip` | |
| 21 | +| Linux x64 | AppImage | `*.AppImage` | |
| 22 | +| Windows x64 | NSIS installer | `*.exe` | |
| 23 | + |
| 24 | +The release workflow also uploads updater manifests and differential payload metadata: |
| 25 | + |
| 26 | +- `latest-mac*.yml` |
| 27 | +- `latest-linux.yml` |
| 28 | +- `latest.yml` |
| 29 | +- `*.blockmap` |
| 30 | + |
| 31 | +### Intel compatibility artifact |
| 32 | + |
| 33 | +The separate [`release-intel-compat.yml`](../../.github/workflows/release-intel-compat.yml) workflow produces the non-blocking macOS x64 compatibility build. It is **not** part of the coordinated stable release attachment set unless it is uploaded separately after that workflow runs. |
| 34 | + |
| 35 | +### macOS code signing and notarization |
| 36 | + |
| 37 | +All coordinated macOS DMG and ZIP payloads are expected to be code-signed with the Apple Developer ID certificate and notarized before release publication. Gatekeeper verifies the signature on first launch. |
| 38 | + |
| 39 | +## Electron updater metadata |
| 40 | + |
| 41 | +| File | Purpose | |
| 42 | +| ------------------ | --------------------------------------------------------- | |
| 43 | +| `latest-mac*.yml` | macOS update manifest | |
| 44 | +| `latest-linux.yml` | Linux update manifest | |
| 45 | +| `latest.yml` | Windows update manifest | |
| 46 | +| `*.blockmap` | Differential download block maps for Electron auto-update | |
| 47 | + |
| 48 | +## iOS (TestFlight) |
| 49 | + |
| 50 | +The iOS build is uploaded directly to App Store Connect / TestFlight by the coordinated release workflow. No IPA is attached to the GitHub Release. |
| 51 | + |
| 52 | +| Detail | Value | |
| 53 | +| ----------------- | ----------------------------- | |
| 54 | +| Bundle ID | `com.openknots.okcode.mobile` | |
| 55 | +| Marketing version | `0.22.0` | |
| 56 | +| Build number | Set from `GITHUB_RUN_NUMBER` | |
| 57 | + |
| 58 | +## Checksums |
| 59 | + |
| 60 | +SHA-256 checksums are not committed in-repo. Verify downloads through the GitHub release UI or with `gh release download` followed by local checksum generation if needed. |
0 commit comments