Mencipta dan Mengurus Keluaran

Ciri Keluaran GitHub membantu anda membungkus dan menyediakan versi stabil perisian anda kepada pengguna. Anggaplah ia sebagai pengumuman rasmi tentang versi baharu.

Ia penting untuk projek yang perlu mengedarkan binari tersusun, dokumentasi atau petikan kod sumber tertentu.

Setiap Keluaran GitHub dikaitkan secara langsung dengan teg Git. Teg menandakan titik tertentu dalam sejarah repositori anda, biasanya nombor versi seperti v1.0.0.

• Teg menyediakan rujukan kekal dan tidak berubah kepada komit.
• Keluaran menambahkan metadata terperinci (seperti nota keluaran dan aset) pada teg ini.

Sebelum mencipta keluaran, pastikan anda telah menolak teg yang dikehendaki ke GitHub!

Nota keluaran ialah penerangan yang menjelaskan perkara baharu, perkara yang ditambah baik atau perkara yang dibaiki dalam versi tertentu. Nota ini penting untuk menyampaikan perubahan kepada pengguna anda.

• Gunakan bahasa yang jelas dan ringkas.
• Serlahkan ciri utama dan pembaikan pepijat.
• Pemformatan Markdown disokong untuk teks berformat.

Aset keluaran ialah fail yang boleh dilampirkan pada keluaran supaya tersedia untuk dimuat turun. Ini boleh merangkumi:

• Binari tersusun (contohnya, .exe, .dmg)
• Kod sumber termampat (.zip, .tar.gz)
• Fail dokumentasi atau pemasang

Aset ini menyediakan semua yang diperlukan pengguna untuk versi tertentu itu di satu tempat.

Untuk mencipta keluaran:

1. Pergi ke repositori anda di GitHub.
2. Klik 'Releases' (biasanya terdapat pada bar sisi kanan atau di bawah tab 'Code').
3. Klik butang 'Draft a new release'.

Borang untuk menentukan butiran keluaran anda akan dibuka.

Pada halaman penciptaan keluaran, anda akan:

• Memilih teg Git sedia ada atau mencipta teg baharu.
• Menyediakan tajuk keluaran (contohnya, 'Versi 1.0.0 - Keluaran Awal').
• Menulis nota keluaran terperinci anda.

Anda boleh menandakannya sebagai 'pra-keluaran' (untuk ujian) atau menerbitkannya terus.

GitHub boleh membantu anda menjana nota keluaran secara automatik!

Dengan mengklik 'Generate release notes', GitHub akan mengimbas komit dan permintaan tarik yang digabungkan sejak teg keluaran terakhir, kemudian mencadangkan ringkasan. Anda boleh menyunting dan memperkemasnya selepas itu.

Setelah nota keluaran anda siap, anda boleh memuat naik aset.

Seret dan lepaskan fail ke kawasan yang ditetapkan atau klik untuk menyemak imbas. GitHub akan memuat naiknya dan fail tersebut akan muncul sebagai fail yang boleh dimuat turun pada halaman keluaran anda.

Kesilapan boleh berlaku! Anda sentiasa boleh menyunting atau memadam keluaran.

• Pada halaman 'Releases', cari keluaran yang ingin anda ubah.
• Klik ikon pensel untuk menyunting atau ikon tong sampah untuk memadam.

Penyuntingan membolehkan anda mengubah nota, tajuk atau aset. Pemadaman mengalih keluar keluaran daripada GitHub, tetapi teg Git yang mendasarinya kekal.

Anda telah mempelajari cara mencipta dan mengurus Keluaran GitHub!

• Keluaran menyediakan petikan projek anda yang rasmi dan mempunyai versi.
• Keluaran dibina berdasarkan teg Git serta merangkumi nota keluaran dan aset pilihan.
• Anda boleh mencipta, menyunting dan memadam keluaran melalui antara muka pengguna GitHub.

Ini membantu pengguna mencari dan memuat turun versi stabil perisian anda dengan mudah.