Kanal rilis
Dist-tag stable, canary, dan LTS, versi serempak, provenance, dan penerbitan rilis.
Text.js dirilis melalui tiga dist-tag npm. Setiap paket (@textjs/app, @textjs/react, @textjs/core, @textjs/font, @textjs/opencode, create-text-app dan eslint-plugin-textjs) menggunakan versi yang diselaraskan, sehingga satu nomor versi mewakili seluruh framework.
Kanal
| Kanal | dist-tag | Versi | Instalasi |
|---|---|---|---|
| Stabil | latest | 1.0.x | bun add @textjs/app |
| Canary | canary | 1.0.x-canary.N | bun add @textjs/app@canary |
| LTS | lts, v1-lts | Diterbitkan setelah 2.0.0 dirilis | bun add @textjs/app@lts |
Gunakan versi stabil di produksi. Gunakan canary untuk mencoba perbaikan dan fitur pada hari keduanya masuk ke dev. Setelah lini LTS tersedia, gunakan lini tersebut jika Anda memperbarui versi setahun sekali.
bun create text-app@canary my-consoleStabil
Rilis stabil mengikuti pemberian versi semantik: versi patch memperbaiki bug, versi minor menambahkan fitur yang kompatibel dengan versi sebelumnya, versi mayor dapat mengubah API secara tidak kompatibel setelah masa penghentian bertahap. Rilis stabil berasal dari canary yang telah lulus seluruh rangkaian pengujian, dan diterbitkan dengan provenance npm.
Canary
Setiap push ke dev di repositori resmi melewati pemeriksaan tipe, pengujian, dan diterbitkan sebagai patch berikutnya dengan akhiran -canary.N:
latest | Push ke dev | Diterbitkan |
|---|---|---|
1.0.0 | pertama | 1.0.1-canary.0 |
1.0.0 | kedua | 1.0.1-canary.1 |
1.0.1 | berikutnya | 1.0.2-canary.0 |
N berlanjut dari nomor canary tertinggi yang sudah ada di npm, sehingga nomor tidak pernah berulang. Versi canary tidak dimasukkan ke repositori melalui commit. Tambahkan [skip canary] ke pesan commit untuk melewati rilis.
Canary adalah build dari dev, branch tujuan penggabungan setiap pull request. Canary dapat mengubah atau menghapus API yang belum dirilis tanpa pemberitahuan. Kunci versi canary tertentu jika Anda bergantung padanya.
Provenance
Rilis diterbitkan dari GitHub Actions dengan npm publish --provenance, yang menghubungkan setiap tarball ke commit dan alur kerja persis yang membuatnya. Verifikasi paket dengan:
npm audit signaturesMenyiapkan rilis
Pengelola menaikkan versi setiap paket workspace secara serentak dengan skrip rilis:
bun run release:version minor # 1.0.0 → 1.1.0 (also: patch, major, canary, stable, x.y.z)bun run release:publish --tag latest --provenancerelease:version menulis ulang setiap package.json dan konstanta versi yang mencerminkannya (VERSION, rendererVersion milik reconciler), menolak berjalan jika versi paket tidak lagi selaras, dan --dry-run mencetak rencananya. release:publish membuat build, mengemasnya (menyelesaikan workspace:*), menerapkan publishConfig, menolak menempatkan prarilis di latest atau versi stabil di canary, dan melewati versi yang sudah ada di npm.
Lihat Kebijakan dukungan untuk mengetahui berapa lama setiap lini rilis dipelihara.