0Pricing
Swift Academy · Pelajaran

Pembuatan versi semantik dan penandaan rilis

Terapkan Pembuatan Versi Semantik (MAJOR.MINOR.PATCH), buat tag git beranotasi, dan rujuk versi dalam dependensi SwiftPM dengan jelas.

Pembuatan versi semantik dan penandaan rilis adalah pelajaran Swift Academy gratis di CoddyKit. Ini adalah pelajaran 2 dari 3. Kamu bisa membaca pelajaran lengkapnya di bawah secara gratis — lalu praktikkan langsung di browser dengan editor kode bawaan dan tutor AI 24/7. Ini adalah bagian dari jalur belajar Swift Academy, dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus Swift Academy mencakup 3 pelajaran total.

Apa itu SemVer?

SemVer = MAJOR.MINOR.PATCH.

  • MAJOR: perubahan yang tidak kompatibel
  • MINOR: fitur baru, kompatibel dengan versi sebelumnya
  • PATCH: perbaikan kesalahan, dokumentasi, dan peningkatan kecil

Kapan menaikkan versi

Pilih kenaikan versi:

  • Hapus/ganti nama API publik → MAJOR
  • Tambahkan API baru tanpa merusak kompatibilitas → MINOR
  • Refaktor internal / perbaikan kesalahan → PATCH

Alur kerja pemberian tag Git

Buat tag beranotasi (misalnya, v1.2.0) lalu kirimkan ke repositori. SwiftPM menentukan paket berdasarkan tag git.

// Create an annotated tag and push it so SwiftPM can resolve it.
// Prereqs: tests pass; CHANGELOG updated.
//
//   git add -A
//   git commit -m "Release 1.2.0: new JSON helpers"
//   git tag -a v1.2.0 -m "v1.2.0"
//   git push --follow-tags
//
// Note: use the "v" prefix consistently (e.g., v1.2.0).
print("Tagged v1.2.0 and pushed with --follow-tags")

Persyaratan versi SwiftPM

Dalam Package.swift, pilih gaya persyaratan: from:, exact:, .upToNextMajor, atau .upToNextMinor.

// Package.swift (illustrative dependency specs)
// dependencies: [
//   // Compatible with 1.x (>=1.2.0, <2.0.0)
//   .package(url: "https://example.com/Lib.git", from: "1.2.0"),
//
//   // Exact pin:
//   // .package(url: "https://example.com/Lib.git", exact: "1.2.3"),
//
//   // Up to next major (same as "from:"):
//   // .package(url: "https://example.com/Lib.git", .upToNextMajor(from: "1.2.0")),
//
//   // Up to next minor (>=1.2.0, <1.3.0):
//   // .package(url: "https://example.com/Lib.git", .upToNextMinor(from: "1.2.0"))
// ]
print("Declare dependency ranges clearly: from/exact/upToNextMajor/upToNextMinor")

Kebiasaan membuat CHANGELOG

Ringkas perubahan untuk setiap versi. Soroti item BREAKING dengan jelas agar pengguna dapat meningkatkan versi dengan aman.

// Keep a concise CHANGELOG with headings per version.
//
// # Changelog
// ## [1.2.0] - 2025-09-19
// - Add JSON.encodePretty(_:) (non-breaking)
// - Fix crash in Parser.parse() on empty input
//
// ## [2.0.0] - 2026-01-10
// - BREAKING: Renamed Parser.parse(_:) -> Parser.run(_:)
print("Write a short, helpful CHANGELOG for each release")

Tips pra-rilis

Pra-rilis (misalnya, 2.0.0-beta.1) menandakan ketidakstabilan. Hindari membuat tag jika Anda tidak ingin pengguna memilihnya secara bawaan. Pertahankan penamaan tag yang konsisten.

Aturan kenaikan versi SemVer

Pemeriksaan singkat: Kapan Anda menaikkan MAJOR?

Ringkasan

Ringkasan: Gunakan SemVer (MAJOR.MINOR.PATCH), buat tag git beranotasi seperti v1.2.0, tentukan rentang versi dependensi dalam Package.swift, dan pelihara CHANGELOG yang jelas.

Pertanyaan yang Sering Diajukan

Apakah pelajaran “Pembuatan versi semantik dan penandaan rilis” gratis?

Ya — teks lengkap “Pembuatan versi semantik dan penandaan rilis” gratis dibaca di sini di web. Untuk praktiknya secara interaktif (editor kode bawaan dan tutor AI 24/7) dan buka sisa kursus Swift Academy, upgrade ke CoddyKit PRO. Kursus Swift Academy mencakup 3 pelajaran total.

Apa yang akan aku pelajari di “Pembuatan versi semantik dan penandaan rilis”?

Terapkan Pembuatan Versi Semantik (MAJOR.MINOR.PATCH), buat tag git beranotasi, dan rujuk versi dalam dependensi SwiftPM dengan jelas. Kamu berlatih Swift Academy dengan kode praktik yang langsung kamu jalankan di browser, dan tutor AI 24/7 menjawab pertanyaanmu saat kamu mengerjakan pelajaran ini.

Apakah aku perlu pengalaman untuk memulai Swift Academy?

Tidak diperlukan pengalaman sebelumnya. Swift Academy di CoddyKit dirancang untuk pemula hingga pelajar tingkat lanjut, jadi kamu bisa memulai di sini atau dari awal dan belajar sesuai kecepatan kamu sendiri. Ini adalah pelajaran 2 dari 3.

Berapa lama pelajaran “Pembuatan versi semantik dan penandaan rilis” memakan waktu?

Sebagian besar pelajaran CoddyKit memakan waktu sekitar 5–10 menit. Setiap pelajaran ringkas dan interaktif, jadi kamu membuat kemajuan stabil dan melanjutkan dari tempat kamu tinggalkan di web dan aplikasi.

Bisakah aku menulis dan menjalankan kode dalam pelajaran Swift Academy ini?

Ya. Setiap pelajaran Swift Academy menyertakan editor kode bawaan, jadi kamu menulis dan menjalankan kode nyata langsung di browser dan mendapatkan umpan balik AI instan — tidak diperlukan penyiapan lokal.

Semua pelajaran dalam kursus ini

  1. Paket pustaka vs paket yang dapat dieksekusi
  2. Pembuatan versi semantik dan penandaan rilis
  3. Dasar-dasar CI dengan swift test dan artefak
← Kembali ke Swift Academy