Bermigrasi ke Cloud Code untuk IntelliJ

Dokumen ini menjelaskan cara memigrasikan project App Engine berbasis IntelliJ Anda ke Cloud Code for IntelliJ.

Sebelum memulai

  • Jika project Anda berbasis Maven atau Gradle dan menggunakan plugin berbasis App Engine SDK lama (misalnya, com.google.appengine.appengine-maven-plugin dan com.google.appengine:gradle-appengine-plugin), Anda harus terlebih dahulu bermigrasi ke plugin Maven dan Gradle berbasis gcloud CLI yang baru.

  • Plugin baru tidak mendukung peningkatan Datanucleus. Jika bergantung pada fitur ini, Anda harus mengonfigurasi peningkatan Datanucleus (JDO, JPA) secara manual agar project Anda dapat dimigrasikan ke Cloud Code. Anda harus menggunakan Objectify sebagai lapisan ORM saat membaca/menulis ke Datastore.

Menginstal plugin baru

Jika Anda belum melakukannya, instal plugin dengan melakukan langkah berikut:

  • Pastikan Anda memiliki versi IDE yang didukung, JetBrains IDE versi 2022.3+ (seperti IntelliJ Ultimate/Community, PyCharm Professional/Community, WebStorm, GoLand), di PATH komputer Anda.
  • Buka IntelliJ IDEA (atau JetBrains IDE yang didukung).
  • Buka jendela marketplace plugin menggunakan File > Settings > Plugins. Untuk Mac OS X, gunakan IntelliJ IDEA > Preferences > Plugins.

  • Telusuri plugin 'Cloud Code' lalu instal.

    Anda mungkin akan diminta untuk memulai ulang IDE guna mengaktifkan plugin.

Mengonfigurasi IntelliJ dan project Anda

Setelah menginstal plugin, konfigurasikan IntelliJ dan project Anda untuk menggunakan plugin baru sebagai berikut:

  1. Saat diberi tahu bahwa plugin baru bertentangan dengan integrasi App Engine yang ada, klik link pada perintah.

    Screenshot yang menunjukkan notifikasi bahwa plugin bertentangan. Klik 'klik di sini' untuk menonaktifkan plugin.

  2. Dalam perintah Nonaktifkan Plugin berikut, pilih 'Disable and Restart' untuk menonaktifkan plugin App Engine, lalu mulai ulang IDE agar perubahan konfigurasi plugin diterapkan.

    Screenshot menampilkan perintah yang menanyakan apakah Anda ingin menonaktifkan plugin App Engine dan memulai ulang IDE.

  3. Saat diberi tahu bahwa project Anda menggunakan format lama, klik opsi Convert project Anda ke format baru.

  4. Anda harus menghapus Server App Engine dan instance Cloud yang ada dan membuatnya kembali menggunakan gcloud CLI baru.

    1. Buka Settings > Build, Execution, Deployment > Application Servers.

    2. Pilih instance App Engine Dev Anda dan klik Delete (-).

    3. Klik Add (+) dan pilih Google App Engine Dev Server.

      Screenshot menampilkan daftar server aplikasi serta ikon untuk menghapus dan menambahkannya.

    4. Buka Settings > Build, Execution, Deployment > Clouds.

    5. Pilih instance cloud Google App Engine Anda, lalu klik Delete (-).

    6. Klik Add (+) untuk mengonfigurasi target deployment cloud App Engine.

      Screenshot yang menampilkan daftar instance cloud serta ikon untuk menghapus dan menambahkannya.

  5. Jika memiliki konfigurasi yang dijalankan server lokal App Engine, Anda harus mengupdatenya agar dapat menggunakan Server Aplikasi yang baru dikonfigurasi.

  6. Buka Alat > Cloud Code > App Engine guna melihat daftar tindakan yang tersedia bagi Anda untuk menjalankan dan men-deploy aplikasi, atau lihat dokumentasi untuk mengetahui informasi selengkapnya.

  7. Untuk project berbasis Maven atau Gradle, pastikan Anda menggunakan versi terbaru plugin Gradle dan Maven App Engine.

Mengonfigurasi project khusus IntelliJ

Khusus project khusus IntelliJ (yaitu, project yang telah mengonfigurasi setelan project secara manual dengan faset App Engine lama dan tidak disinkronkan dari Gradle atau Maven), update dependensi App Engine Anda.

Dependensi App Engine Anda masih dikonfigurasi sebagai 'Library Eksternal' dan disediakan oleh penginstalan App Engine SDK lama. Jika Anda menghapus penginstalan App EngineSDK, aplikasi Anda tidak akan dikompilasi.

Screenshot yang menampilkan daftar library eksternal.

Untuk menghapus dependensi ini pada App Engine SDK lama, konfigurasikan dependensi API App Engine Anda menggunakan fitur impor library App Engine Facet sebagai berikut:

  1. Pengguna fitur peningkatan Datanucleus JDO/JPA plugin lama perlu mentransfer aplikasi mereka ke Maven atau Gradle karena peningkatan Datanucleus tidak didukung oleh plugin Cloud Code.

  2. Dari UI IntelliJ Project Structure, buka tab dependensi modul App Engine Standard.

  3. Hapus semua library terkait App Engine.

    Screenshot menampilkan daftar library eksternal dan ikon untuk menghapusnya.

  4. Di UI Project Structure yang sama, buka faset Google App Engine pada modul App Engine Anda.

  5. Di panel Library, pilih dependensi App Engine yang Anda gunakan.

    Screenshot menampilkan daftar library yang tersedia untuk dipilih.

    Tindakan ini akan otomatis mengambil dependensi tersebut dari Maven Central dan menambahkannya ke classpath modul Anda.

  6. Jalankan secara lokal dan deploy untuk memverifikasi bahwa konfigurasi baru Anda berfungsi.

  7. Pada tahap ini, Anda dapat menghapus App Engine SDK lama dengan aman.

Dapatkan dukungan

Untuk mengirimkan masukan atau melaporkan masalah di IntelliJ IDE, buka Alat > Cloud Code > Bantuan / Tentang > Kirim masukan atau laporkan masalah untuk melaporkan masalah di GitHub, atau ajukan pertanyaan di Stack Overflow.