Proses Rilis - redjoel/OpenSID GitHub Wiki

Panduan ini menjelaskan langkah-langkah untuk melakukan rilis OpenSID.

Rilis OpenSID versi resmi dilakukan pada tanggal 1 setiap bulan. Tetapi perbaikan dan penambahan fitur dilakukan secara terus-menurus. Perubahan yang telah rampung langsung dimasukkan ke branch master sebagai versi pra-rilis yang dapat diunduh kapan saja.

Semua pengembangan perlu dihentikan dua hari sebelum rilis, untuk memberi waktu khusus untuk testing dan persiapan rilis. Dalam dua hari tersebut, perubahan masih mungkin dilakukan, untuk memperbaiki masalah yang ditemukan saat testing.

Langkah-langkah membuat rilis:

1. Lakukan testing untuk memastikan semua perubahan bekerja sesuai yang diinginkan
2. Ubah nomor versi di opensid_helper.php
3. Ubah nama file catatan_rilis_[versi-1]_pasca.txt menjadi catatan_rilis_[versi].txt. Lengkapi catatan rilis di file tersebut.
4. Tambahkan baris migrasi untuk [versi] di array $versionMigrate di file donjo-app/models/Database_model.php, seperti contoh berikut: '19.05' => array('migrate' => NULL, 'nextVersion' => NULL)
5. Lengkapi contoh data awal menggunakan langkah berikut:
   1. Restore database ke contoh data awal untuk [versi-1].
   2. Jalankan Database > Migrasi DB.
   3. Jalankan Database > Backup untuk menghasilkan contoh data awal untuk [versi].
   4. Yakinkan restore database menggunakan contoh data awal baru berjalan sukses.
   5. Hapus file contoh data awal untuk [versi-1].
6. Lakukan testing install baru menggunakan contoh data awal. Lakukan testing upgrade menggunakan menu Database > Migrasi DB
7. Commit semua perubahan ke branch master
8. Siapkan draft rilis di https://github.com/OpenSID/OpenSID/releases, menggunakan tag vxx.yy, di mana xx adalah dua digit terakhir tahun, dan yy adalah nomor bulan (contoh v18.06 untuk rilis bulan Juni 2018)
9. Publish rilis
10. Update situs demo http://demo.opensid.my.id dengan rilis baru
11. Umumkan rilis di Forum Pengguna dan Pegiat OpenSID di https://www.facebook.com/groups/OpenSID/
12. Lengkapi panduan

Testing

Testing perlu melibatkan sebanyak mungkin pengguna. Selalu usahakan memuat versi pra-rilis terkini di situs demo, dan ajak semua anggota komunitas OpenSID di https://www.facebook.com/groups/OpenSID/ untuk ikut mengujicoba dan melaporkan masalah yang ditemukan.

[Masih dalam penulisan. Silakan bantu]

Lengkapi Contoh Data Awal

Contoh data awal perlu dilengkapi untuk membantu menjelaskan perbaikan atau fitur baru yang ditambahkan di rilis.

Cara untuk melengkapi data contoh awal (tidak perlu menyunting berkas .sql secara langsung):

1. Restore data contoh awal menggunakan menu Database > Backup/Restore
2. Kalau ada perubahan yg dilakukan melalui migrasi, jalankan Database > Migrasi DB
3. Ubah/tambah data yang diperlukan melalui fitur aplikasi biasa
4. Buat data contoh awal yang baru dengan melakukan backup melalui menu Database > Backup/Restore
5. Ubah nama berkas data contoh menggunakan tanggal waktu melakukan backup.

Pembuatan Installer

Untuk setiap rilis versi resmi diusahakan adanya installer untuk Windows, supaya memudahkan pengguna pemula yang baru mulai menerapkan OpenSID. Tautan ke installer setiap rilis perlu ditambahkan pada catatan rilis di https://github.com/OpenSID/OpenSID/releases. Untuk versi update (update pack) juga akan diterapkan dalam bentuk installer yang akan memudahkan pengguna yang kurang paham dalam penanganan teknis OpenSID dalam melakukan proses update OpenSID

Berikut ini diberikan dua cara untuk membuat installer OpenSID untuk Windows. Silakan pilih cara yang diinginkan.

• Petunjuk pembuatan installer untuk Windows menggunakan innosetup ada di Pembuatan Installer Menggunakan Innosetup.
• Petunjuk pembuatan installer untuk Windows menggunakan NSIS (Nullsoft Scriptable Install System) ada di Pembuatan-Installer-OpenSID-dengan-menggunakan-NSIS.

Lengkapi Panduan

Perbaiki atau lengkapi panduan di Wiki OpenSID sesuai dengan perubahan atau penambahan fitur yang dilakukan di rilis.

Petunjuk melengkapi panduan ada di Mengembangkan Panduan OpenSID.