Menerbitkan Aplikasi Solana Mobile: Panduan Praktis

Materi

Ikuti panduan ini dan kumpulkan materi yang diperlukan untuk penerbitan, dengan tujuan menghasilkan Android Package Kit (APK) yang siap dirilis. Berikut adalah daftar periksa materi yang perlu dikumpulkan dan disiapkan untuk langkah-langkah penerbitan.

Daftar Periksa

• Build siap rilis
• Android Build Tools
• Informasi versi
• Alat pelaporan error seperti Sentry
• Aset dApp dan dApp store
• URL RPC Helius
• Kunci Penandatanganan Aplikasi 
• Kunci Penerbit
• Syarat & Perjanjian 
• Lisensi
• Kebijakan Privasi
• Hak Cipta

Saat menerbitkan ke app store, terdapat syarat dan ketentuan bagi penerbit dan konsumen. Hal ini penting untuk melindungi pengguna dan membatasi tanggung jawab penerbit. Sebelum menerbitkan, penerbit Solana dApp store menyetujui kebijakan penerbit, perjanjian penerbitan dApp, dan ketentuan penggunaan dApp store.

Penerbit harus menyediakan perjanjian lisensi pengguna akhir (EULA), kebijakan privasi, dan hak cipta dalam proses penerbitan. Sebagai pengembang, dapatkan dokumen-dokumen ini dan sediakan secara online – tautan ke dokumen tersebut akan diperlukan dalam proses penerbitan. Lihat sumber daya seperti generator kebijakan privasi, contoh pemberitahuan hak cipta, atau gunakan ChatGPT untuk membuat dokumen tersebut.

Persiapan

Persiapan peluncuran dApp dimulai dengan build yang dikonfigurasi untuk rilis. 

Pertama, rapikan repositori. Hapus log konsol dan gunakan alat pelaporan error untuk memantau dApp. Variabel lingkungan juga perlu ditinjau dan diperbarui untuk lingkungan produksi.

Selanjutnya, pastikan semua aset memiliki ukuran yang tepat dan file yang tidak diperlukan telah dihapus. Gambar pratinjau untuk dApp store harus memiliki resolusi 1080p (1920px kali 1080px) dan semuanya harus berorientasi horizontal atau vertikal. Ukuran maksimum ikon dApp store adalah 512x512px, dan filenya harus berbentuk persegi.

Saat menerbitkan ke dApp store, diperlukan keypair Solana. Buat keypair baru dengan solana-keygen dan danai dengan Solana untuk digunakan nanti. Simpan keypair ini dengan aman. Jika tidak, siapa pun yang memiliki keypair tersebut dapat mengajukan rilis dApp berikutnya ke dApp store.

Saat aplikasi dibuat untuk dirilis, build harus ditandatangani dengan kunci aplikasi. Aplikasi baru memerlukan kunci penandatanganan baru; jangan gunakan kunci yang sama dengan debug. Seperti kunci penerbitan, siapa pun dapat memperbarui aplikasi menggunakan kunci aplikasi. Buka terminal dan tempel perintah berikut untuk membuat kunci penandatanganan aplikasi menggunakan keystore.

keytool -genkey -v -keystore release-key.keystore -alias alias_name -keyalg RSA -keysize 2048 -validity 10000

Buat release-key.keystore dan storePassword (juga berfungsi sebagai keyPassword) di direktori saat ini. Gunakan contoh kode berikut untuk membuat signingConfigs dan buildTypes rilis di build.gradle.

signingConfigs {
        release {
            storeFile file('release.keystore')
            storePassword 'password'
            keyAlias 'release-key'
            keyPassword 'password'
        }
    }
    buildTypes {
        debug {
            signingConfig signingConfigs.debug
        }
        release {
            signingConfig signingConfigs.release
            minifyEnabled enableProguardInReleaseBuilds
            proguardFiles getDefaultProguardFile("proguard-android.txt"), "proguard-rules.pro"
            debuggable false
        }
    }

Dalam file yang sama, tetapkan locale(s) aplikasi serta perbarui versionCode dan versionName. Ini adalah kesempatan terakhir untuk mengubah applicationId.

Setelah penandatanganan rilis dikonfigurasi, dApp siap dibuat untuk produksi. Di direktori dApp, jalankan perintah berikut untuk membersihkan resource duplikat dari debug dan melakukan perakitan untuk rilis.

Jika berhasil, perintah tersebut akan menghasilkan APK di folder /android/app/build/outputs/apk.

yarn react-native bundle --platform android --dev false --entry-file index.js --bundle-output android/app/src/main/assets/index.android.bundle --assets-dest android/app/build/intermediates/res/merged/release/ && rm -rf android/app/src/main/res/drawable-* && rm -rf android/app/src/main/res/raw/* && cd android && ./gradlew assembleRelease && cd ..

Langkah-Langkah Penerbitan

Penerbitan ke dApp store memerlukan penggunaan alat CLI milik store tersebut. Bagian ini merangkum langkah-langkah penyiapan dari Solana Mobile untuk menerbitkan di dApp store:

1. Instal alat CLI dApp store.
2. Buat dan validasi config.yaml.
3. Mint NFT App, Publisher, dan Release.
4. Ajukan dan terbitkan.

Di direktori penerbitan, jalankan perintah berikut:

pnpm init
pnpm install --save-dev @solana-mobile/dApp-store-cli
npx dApp-store init

Perintah inisialisasi akan membuat file config.yaml. File ini digunakan untuk mengonfigurasi tampilan dApp di dApp store. Ada tiga bagian yang harus diisi: publisher, app, dan release.

Semua bagian ini memiliki kolom alamat yang harus dibiarkan kosong untuk rilis awal. Langkah-langkah penerbitan akan membuat NFT untuk setiap bagian dan memperbarui alamat secara otomatis.

Ini adalah referensi kosong untuk config.yaml, sedangkan versi yang telah diisi sebelumnya tersedia di GitHub dapp-publishing.

publisher:
  name:
  address:
  website:
  email:
  media:
    - purpose: icon
      uri:
app:
  name:
  address:
  android_package:
  urls:
    license_url:
    privacy_policy_url:
    copyright_url:
    website:
  media:
    - purpose: icon
      uri:
release:
  address:
  media:
    - purpose: icon
      uri:
    - purpose: screenshot
      uri:
    - purpose: screenshot
      uri:
    - purpose: screenshot
      uri:
  files:
    - purpose: install
      uri:
  catalog:
    en-US:
      name:
      short_description:
      long_description:
      new_in_version:
      saga_features:
solana_mobile_dApp_publisher_portal:
  google_store_package:
  testing_instructions:

Bagian rilis dapat diubah untuk pembaruan baru aplikasi. Isi kolom media untuk menampilkan gambar pratinjau dan ikon di dApp store. Path menuju APK perlu diberikan agar file dapat diinstal. Tempatkan file-file ini dalam repositori penerbitan dan berikan path relatifnya sebagai URI. Deskripsi aplikasi dapat diedit dalam katalog, sedangkan kolom seperti google_store_package, saga_features bersifat opsional.

Setelah config.yaml diisi, periksa validitas publikasi menggunakan perintah berikut dengan path menuju keypair Solana dan Android Build Tools.

Jika Android Build Tools diinstal bersama Android Studio, path-nya dapat ditemukan dengan membuka Android Studio, mengeklik menu tarik turun Tools, lalu memilih SDK Manager.

Buka tab SDK Tools, lalu klik Android_SDK_Build_Tools 34 untuk menampilkan path menuju build tools. Path tersebut akan terlihat seperti ini: C:\Users\user\AppData\Local\Android\Sdk.

npx dApp-store validate -k path_to_keypair -b path_to_android_sdk_build_tools

Untuk menerbitkan ke dApp store, NFT dibuat untuk setiap bagian dari config.yaml

Mulailah dengan membuat Publisher NFT. Ini adalah operasi satu kali, sehingga langkah ini tidak diperlukan untuk rilis berikutnya. Ganti mainnet_beta_rpc_url dengan URL RPC Helius.

npx dApp-store create publisher -k path_to_your_keypair -u mainnet_beta_rpc_url

Pembuatan App NFT juga merupakan perintah satu kali. Perintah ini akan membuat App NFT dan mencatat alamat mint di config.yaml.

npx dApp-store create app -k path_to_keypair -u mainnet_beta_rpc_url

Gunakan perintah berikut untuk membuat Release NFT. Release NFT baru harus dibuat saat rilis baru diajukan ke dApp store. Alamat mint diperbarui secara otomatis setiap kali perintah dijalankan.

npx dApp-store create release -k path_to_keypair -b path_to_android_sdk_build_tools -u mainnet_beta_rpc_url

Setelah ketiga NFT berhasil dibuat, aplikasi siap diajukan ke dApp store.

Terbitkan dengan perintah di bawah ini dan sertakan flag --requestor-is-authorized --complies-with-solana-dApp-store-policies untuk menyatakan kepatuhan.

npx dApp-store publish submit -k path_to_keypair -u mainnet_beta_rpc_url --requestor-is-authorized --complies-with-solana-dApp-store-policies

Setelah dApp diajukan ke dApp store, tim Solana Mobile akan menghubungi alamat email yang digunakan di bagian penerbit. Anda juga dapat menghubungi tim Solana Mobile melalui kanal #dapp store. Waktu peninjauan biasanya dua hingga tiga hari untuk pengajuan aplikasi baru dan satu hari untuk pembaruan.

Catatan Setelah Peluncuran

Tantangan menerbitkan ke dApp store mungkin terasa menakutkan bagi penerbit pertama kali, tetapi prosesnya dapat disederhanakan dengan alat yang tepat. Saat Chonky dApp diluncurkan, selain kendala seluler seperti modal dompet yang tidak berfungsi dalam mode daya rendah/penghemat baterai dan pengguna yang tidak sabar membatalkan permintaan penandatanganan, pengguna Saga dapat mengeklaim airdrop pada percobaan pertama. Pencatatan error membuktikan pentingnya setelah dApp diluncurkan, dengan memantau error secara real-time dan merekam perilaku pengguna. Dapatkan informasi penggunaan penting dengan memanfaatkan alat pencatatan. Saat ini, Solana Mobile tidak mengumpulkan data seperti jumlah tayangan dan unduhan aplikasi, sehingga pengembang harus menerapkan pencatatan yang sesuai dalam aplikasi mereka. 

Beralih ke perangkat seluler berarti mengutamakan pengguna. Mulai dari desain UX hingga alur kerja penandatanganan, pengembang seluler mengoptimalkan pengalaman terpadu yang mulus saat pengguna menjelajahi antarmuka digital. Di dunia dengan perhatian yang terbatas, aplikasi berupaya mendapatkan tempat di layar utama pengguna. Karena kebijakan penerbitan yang membatasi di app store populer, hanya sedikit aplikasi yang berhasil menghadirkan aplikasi kripto dengan manfaat nyata ke perangkat seluler. Teknologi blockchain Solana memungkinkan pengguna menerima hadiah secara massal, dan Solana Mobile berada di posisi yang tepat untuk memimpin cara orang berinteraksi dengan aplikasi kripto-native. Dengan Saga Chapter 2 yang akan hadir pada 2025, sekarang adalah kesempatan sempurna untuk membangun dApp bagi Solana dApp store.

Jika panduan ini menginspirasi Anda untuk meracik dApp yang unik, berlanggananlah ke blog Helius dan baca artikel tentang edukasi pengembang Solana. Memiliki Saga dan ingin mulai mengembangkan dengan Solana Mobile Stack? Tutorial Token-Gating di Solana Mobile sangat cocok diikuti oleh pengembang Android pemula yang memahami Typescript. Bergabunglah dengan Helius Hacker Society di Discord dan terus ikuti konten lainnya untuk pengembang seluler di Solana. Helius siap membantu menjawab pertanyaan apa pun di Forum Helius.

Sumber Daya Tambahan

• Penyiapan pengembangan seluler Android 
• Referensi Mobile Wallet Adapter
• SDK Solana untuk React Native
• Arsitektur dApp seluler
• Siapkan aplikasi Anda untuk dirilis
• Android Studio
• Repositori GitHub penerbitan dApp Solana Mobile 
• Dokumentasi penerbitan dApp Solana Mobile
• Spesifikasi penerbitan dApp store
• Discord Solana Mobile