Petunjuk untuk developer pi | Step by step membangun aplikasi di pi browser

Apa itu Developer Portal ?

Portal Pengembang adalah Aplikasi Pi yang memungkinkan Anda mendaftar sebagai pengembang dan mendapatkan kredensial pengembang untuk membuat Aplikasi Pi pihak ketiga – aplikasi web yang dapat diakses melalui Browser Pi. Dengan mendeklarasikan URL aplikasi Anda di sini, aplikasi Anda akan dapat mengakses Platform Aplikasi Pi dan berkomunikasi dengan server Pi dan Pi Blockchain.

Aplikasi Anda akan dapat diakses langsung dari URL Anda sendiri di Pi Browser. Anda dapat meletakkan aplikasi Anda di domain apa pun yang Anda inginkan (termasuk domain .pi) dan masih memiliki aplikasi Pi yang berfungsi penuh.

Untuk mengakses fitur ini, buka develop.pi di dalam Pi Browser atau buka Pi Browser dan klik pada ubin develop.pi.

Jika sebelumnya Anda belum mengakui Perjanjian Pengembang Pi, Anda akan mendapatkan munculan yang mengingatkan Anda untuk melakukannya saat Anda mengeklik "Daftarkan Aplikasi".

Mendaftarkan Aplikasi

Sebelum mendaftarkan aplikasi pertama Anda, Anda harus memverifikasi email Anda dalam profil Aplikasi Penambangan Pi Anda. Ini dapat dilakukan dengan mengikuti proses yang tercantum pada langkah 4 dari Daftar Periksa Memulai. 

Membuat Aplikasi Baru

Saat Anda membuka portal pengembang, beranda menampilkan pengantar singkat tentang aplikasi dan beberapa informasi penting. Di bagian bawah halaman, Anda akan melihat tombol "Info Lebih Lanjut" dan "Daftar Aplikasi Baru". Jika sebelumnya Anda telah mendaftarkan aplikasi, Anda akan diperlihatkan halaman Aplikasi Saya seperti di bawah ini. Klik tombol "Aplikasi Baru" untuk memulai proses pendaftaran aplikasi baru Anda.

Formulir pembuatan aplikasi, meliputi langkah-langkah berikut:

Tambahkan Nama Aplikasi
 Jika Anda memiliki proyek Brainstorm yang terkait dengan aplikasi Anda, Anda harus menggunakan nama yang sama.

Deskripsi Aplikasi
  Pilih jaringan
  Lihat tajuk di bawah untuk informasi lebih lanjut

Di masa mendatang, kami dapat membuat jembatan antara Brainstorm dan Portal Pengembang, sehingga seluruh siklus hidup aplikasi mulus.

Pilih jaringan

Ini adalah langkah paling penting dan akan menentukan ke jaringan mana aplikasi Anda terhubung.

Memilih Pi Mainnet akan menghubungkan aplikasi ini saat diakses di Pi Browser ke Pi Mainnet Blockchain. Tidak ada transaksi Test-Pi di Pi Mainnet dan semua transaksi akan menggunakan Pi asli.

Pi Testnet adalah jaringan yang harus dipilih untuk tujuan pengujian. Semua transaksi testnet menggunakan Test-Pi akan disediakan gratis melalui Pi Wallet. Direkomendasikan agar semua proyek dimulai dengan membuat aplikasi testnet dan setelah pengujian membuat aplikasi kedua untuk aplikasi mainnet.

Catatan Penting: Untuk memfasilitasi transaksi, alamat dompet pengembang yang terakhir diakses akan digunakan sebagai alamat dompet proyek. Semua transaksi untuk jaringan yang ditunjuk oleh aplikasi akan diproses menggunakan alamat ini. Jika pengembang belum membuat dompet di Pi Testnet maka semua transaksi akan gagal sampai dibuat. Jika Anda perlu mendaftar untuk dompet, buka wallet.pi dari dalam Pi Browser untuk membuat dompet. Sebelum mendapatkan Pi Mainnet Wallet, diperlukan proses Pi KYC yang memastikan setiap Pioneer adalah orang yang nyata. Karena persyaratan ini, disarankan agar pengembang terlebih dahulu meluncurkan aplikasinya di testnet tempat siapa pun dapat membuat dompet.

Setelah aplikasi Anda terdaftar, beranda Portal Pengembang akan muncul seperti di bawah ini. Dari menu ini Anda dapat mengklik sebuah proyek dan itu akan memuat dasbor aplikasi untuk proyek itu.

Tombol Dasbor

     Klik ? untuk membaca tentang Portal Pengembang
     Tanda + akan membuat aplikasi baru
     👥 adalah fitur hadiah, klik di sini untuk memasukkan kode hackathon 2022 Anda.

Dasbor Aplikasi

Dasbor Aplikasi dalam Portal Pengembang adalah semua informasi yang berkaitan dengan aplikasi. Dari dasbor ini pengembang dapat melakukan pembaruan informasi. Beralih antara tampilan "Ringkasan Aplikasi" dan tampilan "Detail Aplikasi" untuk melihat semua informasi yang relevan dengan aplikasi.

Tangkapan layar di bawah menunjukkan bagaimana Dasbor Aplikasi akan muncul di dalam Portal Pengembang.

 

Daftar Periksa Aplikasi

Daftar periksa ini mencakup semua langkah untuk mendaftarkan aplikasi dan mempersiapkan peluncurannya. 

Ada 9 langkah yang tercakup di halaman ini dan semuanya terdaftar di Daftar Periksa Memulai, langkah 5 hingga 13. Tinjau daftar itu untuk melihat langkah-langkahnya dan biasakan diri Anda dengan langkah-langkah yang diperlukan untuk meluncurkan aplikasi.

Catatan Langkah 8: Verifikasi Kepemilikan Domain

Jika Anda memilih untuk menghosting aplikasi Anda sendiri, Anda harus memverifikasi kepemilikan domain Anda. Ini dimaksudkan untuk menghindari pengembang membuat aplikasi dari situs web yang tidak mereka miliki atau wakili. Misalnya, Anda tidak boleh meniru nama domain wikipedia.com.

Untuk membuktikan kepemilikan Anda atas nama domain, Anda perlu menempatkan file tertentu di root domain Anda. Konten file harus cocok dengan konten bidang teks di kotak abu-abu yang tercantum di Portal Pengembang.

Setelah selesai menempatkan file dengan konten yang benar di root domain Anda, Anda dapat mengklik tombol "Verifikasi domain". Anda akan melihat pesan kesalahan dengan beberapa informasi debug, atau kotak abu-abu akan hilang dan tanda centang hijau akan muncul di sebelah url domain Anda. Kepemilikan domain Anda sekarang diverifikasi, dan Anda dapat mengakses aplikasi Anda melalui Pi Browser dengan mengetikkan url aplikasi Anda di bilah alamat.

 

Konfigurasi Aplikasi

Bidang-bidang berikut semuanya dapat diedit dalam fitur Konfigurasi Aplikasi yang diakses dari dasbor Aplikasi.

Daftar Putih Pengguna.

Jika mendaftarkan Aplikasi yang terhubung dengan Pi Testnet, pengembang memiliki opsi untuk memberikan akses ke semua yang mengunjungi situs atau hanya ke daftar Perintis terpilih. Jika Anda ingin mengizinkan siapa pun untuk menguji aplikasi, biarkan bidang ini kosong. Jika tidak, Anda dapat menambahkan hingga 10 Nama Pengguna Pi untuk membatasi akses. Pionir ini dapat diubah, dihapus, atau ditambahkan setelah pendaftaran.
Opsi Hosting: Dihosting sendiri atau Dihosting oleh Tim Pi Core

Di tengah formulir, Anda akan ditanya apakah Anda ingin aplikasi dihosting sendiri atau dihosting oleh Tim Pi Core.

Dihosting sendiri

Self Hosted berarti Anda yang menangani server aplikasi dan hosting web Anda. Anda memiliki infrastruktur sendiri, dan Andalah yang mengurus operasi harian hosting. Jika Anda memilih opsi ini, Anda akan diminta memasukkan URL frontend aplikasi Anda. Lihat bagian Validasi Frontend di bawah tentang cara memvalidasi URL frontend ini. Untuk waktu terbatas, cobalah layanan hosting Digital Ocean dan dapatkan kredit $200 gratis dengan menggunakan tautan ini untuk mendaftar.
Segera Hadir - Diselenggarakan oleh Pi Core Team

Tim Pi Core akan menghosting aplikasi Anda — Anda tidak akan memiliki manajemen infrastruktur, tidak ada masalah ketersediaan, Anda hanya mengelola basis kode aplikasi. Meskipun opsi hosting mandiri tersedia untuk semua orang, opsi hosting Pi Core Team memerlukan persetujuan dari Pi Core Team. Hosting aplikasi Pi Core Team, jika tersedia untuk aplikasi Anda, difasilitasi melalui Pi App Engine.

Terakhir, saat Anda memilih tindakan ini, alih-alih url frontend, Anda akan dimintai nama pengguna Gitlab. Ini akan berguna bagi Tim Pi Core untuk memberi Anda proyek Gitlab, yang sudah terintegrasi dengan saluran penyebaran Tim Pi Core.

URL produksi

Di bidang ini Anda harus meletakkan URL yang akan diakses oleh Aplikasi ini. Jika ini adalah Aplikasi Mainnet, URL-nya harus berupa URL yang akan Anda berikan kepada Pionir sehingga mereka dapat mengakses aplikasi di dalam Pi Browser. Jika aplikasi testnet maka URL ini harus menjadi URL pengujian Anda yang mungkin atau mungkin tidak Anda berikan. Diperlukan untuk memiliki Https:// URL.
URL pengembangan

Ini adalah URL untuk aplikasi pengembangan yang dijalankan secara lokal (mis. http://localhost:3000/). Ini akan digunakan oleh Sandbox untuk mengakses instans aplikasi lokal Anda. Lihat bagian Sandbox Flag untuk informasi lebih lanjut tentang cara menjalankan aplikasi pengembangan Anda di Sandbox. 

 

kunci API

Dengan Platform Aplikasi Pi hadir API Pi, tempat Anda dapat menjalankan permintaan HTTP. Untuk saat ini hanya dimaksudkan untuk menangani verifikasi dan pembayaran pengguna tetapi lebih banyak kemampuan akan ditambahkan di masa mendatang, seperti membuat percakapan obrolan di Pi Chat dari aplikasi Anda.

Di bagian bawah dasbor aplikasi proyek Anda, Anda dapat melihat bagian yang disebut "Kunci API". Anda memerlukannya untuk mengakses Pi Backend sebagai pengembang aplikasi. Tetap aman! Siapa pun yang memiliki kunci ini dapat berpura-pura menjadi Anda.

Perhatikan bahwa mengakses blockchain Pi publik tidak memerlukan kunci API apa pun. Anda dapat dengan mudah menghasilkan transaksi menggunakan kunci pribadi Aplikasi Anda dan mengirimkannya langsung ke blockchain melalui node publik mana pun (mis., node Anda sendiri, salah satu node core team Pi, atau node lain yang menjalankan "layanan API Blockchain"). Namun, perhatikan bahwa selama periode Enclosed Mainnet saat ini, hanya node Pi Core Team yang mengoperasikan blockchain Pi Mainnet sementara node mana pun dapat mengoperasikan blockchain Pi Testnet. Untuk detail lebih lanjut, lihat draf bab whitepaper yang sudah diperbarui.