Lewati ke konten

Untuk pengembang firmware

Tambahkan firmware Anda ke Updater CE.

Updater CE adalah katalog komunitas dan penginstal untuk firmware khusus. Kembangkan proyek Anda dari basis ROM, publikasikan sebagai repositori publik dengan aset rilis yang benar, tambahkan entri model ke slidia_manifest.xml, uji filter model, dan buka permintaan tarik. Satu repositori dapat melayani setiap model yang didukungnya.

Mulai dari basis ROM

ROM Dasar memberi pengembang firmware khusus fondasi Android yang bersih dengan chip radio nirkabel diaktifkan. Pada Y1 mereka mengaktifkan Wi-Fi dan GPS bersama dengan Bluetooth dan FM pabrik; pada Y2 mereka mengaktifkan Wi-Fi, GPS, dan FM bersama dengan Bluetooth pabrik.

Unduhan dasar ROM untuk pengembangan firmware khusus, dengan versi Android dan fitur nirkabel yang diaktifkan masing-masing
UnduhPerangkatAndroidFitur nirkabel
rom.zipY1 · Type AAndroid 4.2.2Menambahkan Wi-Fi dan GPS ke Bluetooth dan FM pabrik (FM sudah berfungsi di Y1 dari pabrik). Untuk pemutar Y1 yang dikirimkan dengan OS 2.0.0 atau lebih baru.
rom_type_b.zipY1 · Type BAndroid 4.2.2Menambahkan Wi-Fi dan GPS ke Bluetooth dan FM pabrik (FM sudah berfungsi di Y1 dari pabrik). Untuk Y1 pemain yang dikirimkan dengan OS lebih awal dari 2.0.0.
rom_y2.zipY2Android 4.4.2Menambahkan Wi-Fi, GPS, dan FM ke Bluetooth pabrik. Chip radio Y2 diaktifkan sepenuhnya, jadi FM juga tersedia di sini.

Gambar-gambar ini adalah stok basis Android (AOSP) dengan radio nirkabel perangkat diaktifkan, sehingga firmware khusus dapat menambahkan fitur jaringan alih-alih mengganti tumpukan radio. Ini adalah titik awal praktis untuk langkah-langkah penerbitan di bawah ini.

Gunakan nama aset rilis ini

Nama file adalah bagian dari sinyal kompatibilitas. Pertahankan nama yang tepat dan letakkan file ZIP di aset rilis proyek, tidak hanya di pohon sumber repositori.

Nama aset ZIP firmware dan perangkat yang didukung
AsetPerangkatPerangkat kerasArtinya
rom.zipY1Type AY1 perangkat yang dikirimkan dengan OS 2.0.0 atau lebih baru.
rom_type_b.zipY1Type BY1 perangkat yang dikirimkan dengan OS lebih awal dari 2.0.0.
rom_y2.zipY2Y2Paket instalasi lengkap Y2. Pisahkan dari aset Y1 .
Jangan mengganti nama paket agar sesuai dengan model lain. Y1 dan Y2 menggunakan file platform MediaTek dan konfigurasi flashing yang berbeda. Publikasikan paket untuk perangkat keras yang didukungnya.

Cara kerja koneksi

Updater CE membaca manifes sebagai katalognya. Masing-masing <package> baris memberitahukannya nama proyek, repositori, model, dan penangan. Saat pengguna memilih proyek tersebut, Updater memeriksa rilis repositori yang diterbitkan dan mencari a rom*.zip aset.

nyata

Beri nama proyek dan petakan ke model. Y1 dan Y2 memerlukan baris terpisah, meskipun keduanya berbagi repositori.

Rilis yang diterbitkan

Berisi aset ZIP yang dapat diinstal. Sebuah rilis tunggal mungkin berisi paket Y1 Type A, Y1 Type B, dan Y2 secara bersamaan.

Pemasangan pembaruan CE

Menggunakan model yang dipilih untuk memilih paket yang cocok dan jalur flashing khusus model. Pengguna tidak perlu menebak nama file.

Publikasikan proyek dalam lima langkah

  1. Cabangkan repositori Updater CE. Buat garpu Anda sendiri ryan-specter/updater-ce-neo, lalu kloning garpu Anda secara lokal.
  2. Siapkan repositori firmware publik. Pastikan repositori bersifat publik dan rilisnya berisi aset ZIP yang benar. Anda bisa menempatkan rom.zip, rom_type_b.zip, dan rom_y2.zip pada rilis yang sama padahal keduanya berasal dari versi yang sama.
  3. Edit manifes. Buka slidia_manifest.xml di root garpu Updater CE Anda. Tambahkan satu baris untuk setiap model yang didukung rilis (Y1 dan Y2 adalah pasangan yang umum). Itu repo nilainya adalah milik repositori owner/repository; url adalah halaman proyek publik.
  4. Uji katalognya. Jalankan Updater dari checkout yang diedit. Pilih Y1 dan konfirmasikan bahwa proyek menampilkan aset Y1. Pilih Y2 dan konfirmasikan bahwa rilis Y2 ditampilkan. Centang Type A dan Type B secara terpisah ketika keduanya dipublikasikan.
  5. Buka permintaan tarik. Dorong perubahan manifes ke fork Anda dan buka permintaan tarik terhadap repositori Updater CE upstream. Sertakan tautan proyek, model yang didukung, tag rilis, nama aset, dan perangkat yang Anda uji.

Hasilkan garis manifes Anda

Isi repositori dan centang setiap model yang didukung rilis. Generator menulis satu <package> baris per model dan hanya menyertakan atribut yang Anda tetapkan, sehingga hasilnya sesuai dengan yang sekarang slidia_manifest.xml format. Setiap atribut yang dibaca Updater CE tersedia di bawah — atribut opsional ada di bawah Opsi lainnya.

Repositori publik GitHub. Ekstrak generator owner/repository dari URL.
Ditampilkan di aplikasi dan katalog situs.
Halaman yang dapat dilihat manusia untuk proyek atau catatan rilisnya.
Hapus ini untuk menggunakan merek default model. SR1, Q3, Q5 dan Q3e adalah model Timmkoo.
Perangkat (masing-masing satu baris)
Untuk model yang tidak tercantum di atas. Model terkenal menjaga ejaan katalognya.
Bendera

Keep Data hanya ditawarkan ketika firmware yang masuk dan firmware yang diinstal sama atau berbagi a derivative akar. Gunakan tanda ini hanya jika data pengguna benar-benar tidak dapat dipindahkan.

Opsi lainnya: ikon, karya seni, aset rilis, pasca-instalasi, dan mirror

Ikon dan karya seni

Pilih gambar yang akan Anda komit ke repositori. Ini mempratinjaunya dan membuat URL mentahnya; itu tidak mengunggah apa pun.
Jalur ke gambar yang dikomit, relatif terhadap akar repositori.
URL gambar langsung. Jika kosong, aplikasi akan menggunakan rilis tersebut updater.png atau ikon yang dihasilkan.

Ikon tema gelap opsional. image_dark adalah alias yang diterima.
Karya seni sekunder, dicoba setelah gambar rilis dan icon.

Lepaskan aset

Satu nama untuk setiap model yang dipilih. Biarkan kosong untuk digunakan rom.zip pada Y1 dan rom_<model>.zip di tempat lain.
Glob digunakan ketika ritsleting rilis tidak diberi nama rom*.zip.
Glob untuk paket Y1 Type A ketika namanya tidak disebutkan.
Glob untuk paket Y1 Type B ketika namanya tidak disebutkan.
Sembunyikan entri dari versi Updater CE yang lebih lama.

Tautan, cermin, dan keluarga Keep Data

Dibuka setelah instalasi berhasil.
Langkah kedua opsional untuk panduan pengaturan multi-halaman.
Dipisahkan koma *-mirror repositori yang membuat paket Portable Flashing Zip.
Firmware yang digunakan untuk membuat rilis ini. Firmware terkait berbagi partisi data, yang merupakan pemeriksaan Keep Data.
Repo aplikasi yang rilisnya menjelaskan aplikasi dalam firmware ini. Itu juga memerlukan halaman pasca-instalasi.
Repo aplikasi yang APK aplikasinya diunduh dan diinstal setelah firmware.

Ekstra katalog

Pengidentifikasi stabil untuk tautan dan catatan pemasangan yang disimpan. Model ditambahkan secara otomatis ketika beberapa model dipilih.
<package name="Your Firmware" brand="Innioasis" repo="your-account/your-firmware" device="Y1" url="https://github.com/your-account/your-firmware" type="img" handler="Custom Firmware" />
<package name="Your Firmware" brand="Innioasis" repo="your-account/your-firmware" device="Y2" url="https://github.com/your-account/your-firmware" type="img" handler="Custom Firmware" />

Memuat manifes terbaru…

Satu baris saja tidak cukup untuk repositori bersama. Jika baris Y2 tidak ada, pengguna Y2 tidak akan mendapatkan entri yang cocok dengan model meskipun rom_y2.zip ada dalam rilis proyek. Hal yang sama juga berlaku untuk setiap model lain yang didukung rilis Anda.

Setiap atribut yang dibaca manifes

Ini adalah atribut yang dipahami oleh Updater CE build saat ini. Generator hanya menulis yang Anda isi; aplikasi lainnya kembali ke default yang masuk akal.

atribut paket slidia_manifest.xml dan artinya
AtributDibutuhkanApa fungsinya
nameYaNama perangkat lunak ditampilkan di katalog dan di kartu instalasi.
repoYaowner/repo. Aplikasi membaca rilis GitHub repositori tersebut.
deviceYaModel target, huruf besar (Y1, Y2, G1, Q3e, …). Simpan satu entri per model.
urlDirekomendasikanHalaman proyek atau catatan rilis dibuka dari katalog.
type, handlerYa dalam praktiknyatype="img" dan handler="Custom Firmware". Tipe lain dan penangan non-firmware dilewati.
brandOpsionalMerek katalog (Innioasis, Timmkoo). Kosong menggunakan merek default model.
package_nameOpsionalRilis nama file aset. Defaultnya adalah rom.zip pada Y1 dan rom_<model>.zip pada model lain.
asset_patternOpsionalGumpalan yang tidak peka huruf besar-kecil untuk rilis yang ritsleting firmwarenya tidak diberi nama rom*.zip (misalnya my-firmware-*.zip).
type_a_asset, type_b_assetOpsionalGlob yang mengidentifikasi zip Y1 Type A dan Type B ketika nama filenya tidak berisi penanda biasa.
iconOpsionalURL logo. Digunakan setelah rilisnya sendiri updater.png / updater.jpg, dan sebagai pengganti untuk setiap rilis.
icon_darkOpsionalLogo bertema gelap. image_dark adalah alias yang diterima.
imageOpsionalKarya seni ringan sekunder, dicoba setelahnya icon.
post_install, post_install2OpsionalHalaman dibuka setelah instalasi berhasil. Yang kedua mencakup panduan multi-langkah.
portable_zipsOpsionalDipisahkan koma *-mirror repo yang menerbitkan paket portabel yang siap dijalankan.
derivativeOpsionalRepositori tempat firmware dibuat. Firmware dengan root turunan yang sama dapat menyimpan data pengguna.
info_repoOpsionalRepositori aplikasi yang rilisnya menjelaskan apa yang disebarkan firmware. Membutuhkan post_install atau post_install2.
apk_repoOpsionalRepositori aplikasi yang APK aplikasinya diinstal setelah firmware.
min_versionOpsionalSembunyikan entri ketika Updater CE lebih tua dari versi ini.
do_not_keep_dataOpsionaltrue (juga 1 / yes) memblokir Simpan Data sepenuhnya untuk firmware ini.
slugOpsionalPengidentifikasi stabil untuk tautan dan catatan pemasangan yang disimpan. Dihasilkan dari nama dan model saat kosong.
descriptionOpsionalDeskripsi katalog singkat. Ini bisa berupa nilai atribut atau teks elemen.

Nama lama masih dibaca untuk kompatibilitas: model, package, portable_zip, post_install_2, min_app_version dan image_dark. Entri baru harus menggunakan nama saat ini di atas.

Kirimkan baris sebagai permintaan tarik

  1. Salin baris yang dihasilkan di atas. Mereka sudah cocok dengan format manifes terbaru.
  2. Sunting slidia_manifest.xml di repositori. Gunakan tautan edit di bawah; host repositori membuat fork dan cabang untuk Anda secara otomatis.
  3. Tempelkan baris sebelumnya </slidia>, menjaga entri yang ada tidak berubah.
  4. Berkomitmen pada cabang baru (misalnya add-your-firmware), lalu buka permintaan tarik terhadap repositori Updater CE.
  5. Dalam PR, sertakan tautan proyek, model yang didukung, tag rilis, nama aset, dan perangkat yang Anda uji.

Pertahankan nama model dalam huruf besar, gunakan URL persis dari repositori publik Anda, dan simpan type="img" dan handler="Custom Firmware" untuk entri firmware.

Jadikan rilisnya mudah untuk diverifikasi

Berikan label rilis dan catatan rilis yang jelas pada rilis tersebut. Tag ini berguna bagi orang-orang, tetapi nama aset ZIP adalah apa yang digunakan Updater CE untuk mengidentifikasi paket instalasi.

Daftar periksa rilis

  • Publikasikan rilis tersebut secara publik.
  • Lampirkan file ZIP sebagai aset rilis.
  • Nyatakan model yang didukung dan Type A atau Type B dalam catatan.
  • Buat daftar persiapan yang diperlukan atau batasan yang diketahui.

Satu rilis, tiga aset

Rilis bersama dapat berisi rom.zip, rom_type_b.zip, dan rom_y2.zip. Updater mengklasifikasikannya secara terpisah dan memilih dari model dan filter perangkat keras.

Jangan menggabungkan tebakan

Jangan menyertakan paket Y1 di bawah nama file Y2, atau menambahkan data sebar, prapemuat, atau partisi yang belum teruji hanya untuk memunculkan aset.

Mengapa entri model penting selama flashing

Manifes bukan sekedar menu download. Setelah ekstraksi, Updater CE menggunakan model yang diselesaikan untuk menyiapkan jalur instalasi yang cocok. Y1 dan Y2 memiliki file platform, prapemuat, konfigurasi sebar, dan tata letak perangkat yang berbeda.

Kontributor harus memberikan file firmware yang benar, bukan offset flash. Jangan mengedit alamat pencar, prapemuat, file DA, atau perintah partisi untuk mengatasi paket yang buruk. Perbaiki aset rilis dan uji pada model yang diinginkan.

Sebelum Anda meminta penggabungan

  1. Validasi XML dengan parser XML. Kutipan atau penutup hilang /> dapat menyembunyikan setiap entri setelahnya.
  2. Luncurkan pembaru dari checkout Anda sehingga memuat manifes lokal sebelum penyegaran jarak jauh.
  3. Periksa Y1 dan Y2 secara terpisah. Konfirmasikan bahwa proyek hanya muncul jika paketnya didukung.
  4. Periksa daftar rilis untuk rom.zip, rom_type_b.zip, dan rom_y2.zip sebagaimana berlaku.
  5. Uji penginstalan sebenarnya pada perangkat yang dimaksud, dengan kabel data USB yang andal dan rencana pemulihan untuk kembali ke Perangkat Lunak Asli.
  6. Dalam permintaan tarik, jelaskan apa yang Anda uji. Jangan mendeskripsikan model yang belum diuji sebagai model yang didukung.
python -c "from xml.etree import ElementTree as ET; ET.parse('slidia_manifest.xml'); print('manifest ok')"

Untuk pemeriksaan lokal, jalankan perintah itu dari root repositori. Ini memverifikasi sintaks XML saja; itu tidak membuktikan bahwa rilis berisi firmware yang valid atau perangkat aman untuk di-flash.

Memodifikasi keterampilan untuk agen AI

Repositori itu skills/ direktori adalah basis pengetahuan berbasis sumber untuk agen yang mengerjakan Y1 dan Y2 perangkat keras, firmware, tema, dan aplikasi. Setiap keterampilan memberi nama pada file proyek asal klaimnya, sehingga agen dapat memeriksa fakta sebelum mengganti perangkat.

Perangkat keras

Y1 perangkat keras

MT6572, roda sebagai peristiwa penting, tampilan 480x360, jalur FM/audio, penyimpanan dan peta partisi Type A/B.

Perangkat keras

Y2 perangkat keras

Papan MT6582, pohon perangkat, panel GC9503V/ST7701S, rel PMIC/DAC, partisi dan image boot.

Firmware

Paket firmware

rom.zip anatomi, file sebar, kontrak pembaruan Kelas A, dan daftar periksa rilis.

Semua keterampilan

Jelajahi folder keterampilan

Rockbox Y1/Y2, stok ROM Android, Y2Linux, aplikasi Android, peluncur, catatan rilis, dan penerbitan situs.