Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Dokumen ini menjelaskan cara memigrasikan project App Engine berbasis IntelliJ ke Cloud Code for IntelliJ.
Sebelum memulai
Jika project Anda berbasis Maven atau Gradle dan menggunakan plugin berbasis App Engine SDK yang lebih lama (misalnya, com.google.appengine.appengine-maven-plugin dan com.google.appengine:gradle-appengine-plugin), Anda harus bermigrasi terlebih dahulu ke plugin Maven dan Gradle berbasis gcloud CLI yang baru.
Plugin baru tidak mendukung peningkatan Datanucleus. Jika Anda bergantung pada
fitur ini, Anda harus mengonfigurasi peningkatan Datanucleus
(JDO,
JPA)
secara manual untuk project Anda agar dapat bermigrasi ke Cloud Code.
Anda harus menggunakan
Objectify
sebagai lapisan ORM saat membaca/menulis ke Datastore.
Instal plugin baru
Jika Anda belum melakukannya, instal plugin dengan melakukan hal 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' dan instal.
Anda mungkin diminta untuk memulai ulang IDE guna mengaktifkan plugin.
Mengonfigurasi IntelliJ dan project Anda
Setelah menginstal plugin, konfigurasi IntelliJ dan project Anda untuk menggunakan plugin baru sebagai berikut:
Saat diberi tahu bahwa plugin baru bertentangan dengan integrasi
App Engine yang ada, klik link di perintah.
Pada perintah Nonaktifkan Plugin berikut, pilih 'Nonaktifkan dan Mulai Ulang' untuk
menonaktifkan plugin App Engine dan memulai ulang IDE agar perubahan
konfigurasi plugin diterapkan.
Saat diberi tahu bahwa project Anda dalam format lama, klik opsi untuk
Konversi project Anda ke format baru.
Anda harus menghapus instance Server App Engine dan Cloud yang ada, lalu membuatnya ulang menggunakan gcloud CLI baru.
Pilih instance cloud Google App Engine Anda, lalu klik
Hapus (-).
Klik Tambahkan (+) untuk mengonfigurasi target deployment cloud App Engine.
Jika Anda memiliki konfigurasi eksekusi server lokal App Engine, Anda harus memperbaruinya untuk menggunakan Server Aplikasi yang baru dikonfigurasi.
Buka Tools > Cloud Code > App Engine untuk melihat daftar tindakan yang tersedia bagi Anda untuk menjalankan dan men-deploy aplikasi, atau lihat dokumentasi untuk mengetahui informasi selengkapnya.
Untuk project berbasis Maven atau Gradle, pastikan Anda menggunakan plugin App Engine Gradle dan Maven versi terbaru.
Mengonfigurasi project khusus IntelliJ
Khusus untuk project spesifik IntelliJ (yaitu, project yang telah mengonfigurasi setelan project secara manual dengan aspek App Engine lama dan tidak disinkronkan dari Gradle atau Maven), update dependensi App Engine Anda.
Dependensi App Engine Anda masih dikonfigurasi sebagai
'External Libraries' dan disediakan oleh penginstalan SDK App Engine lama Anda. Jika Anda menghapus penginstalan App Engine SDK, aplikasi Anda tidak akan dikompilasi.
Untuk menghapus dependensi ini pada App Engine SDK lama, konfigurasikan dependensi App Engine API Anda menggunakan fitur impor library App Engine Facet sebagai berikut:
Pengguna fitur peningkatan Datanucleus JDO/JPA plugin lama harus mem-porting aplikasi mereka ke Maven atau Gradle karena peningkatan Datanucleus tidak didukung oleh plugin Cloud Code.
Dari UI Project Structure IntelliJ, buka tab dependensi modul App Engine Standard Anda.
Hapus semua library terkait App Engine.
Di UI Project Structure yang sama, buka aspek Google App Engine modul App Engine Anda.
Di panel Libraries, pilih dependensi App Engine yang Anda gunakan.
Tindakan ini akan otomatis mengambil dependensi ini dari Maven Central dan menambahkannya ke classpath modul Anda.
Jalankan secara lokal dan deploy untuk memverifikasi bahwa konfigurasi baru Anda berfungsi.
Pada tahap ini, Anda dapat menghapus App Engine SDK lama dengan aman.
Mendapatkan dukungan
Untuk mengirimkan masukan atau melaporkan masalah di IDE IntelliJ, buka
Tools > Cloud Code > Help / About > Submit
feedback or report an issue untuk melaporkan masalah di GitHub.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-09-04 UTC."],[[["\u003cp\u003eThis guide explains the process of migrating App Engine projects from IntelliJ to Cloud Code for IntelliJ, focusing on necessary configurations and plugin installations.\u003c/p\u003e\n"],["\u003cp\u003eCloud Code supports Java 8 runtimes, but due to the impending deprecation of Java 8 support for App Engine, it is disabled by default and creating new App Engine projects is discouraged.\u003c/p\u003e\n"],["\u003cp\u003eBefore migrating, Maven or Gradle projects using older App Engine SDK plugins should switch to the new gcloud CLI-based plugins, as well as migrate from Datanucleus enhancement.\u003c/p\u003e\n"],["\u003cp\u003eUsers must install the Cloud Code plugin, disable the old App Engine plugin, convert their project format, delete old App Engine server and cloud instances, and ensure they use the latest version of Gradle and Maven App Engine plugins.\u003c/p\u003e\n"],["\u003cp\u003eIntelliJ-specific projects must remove old App Engine SDK dependencies and use the App Engine Facet library import feature to retrieve necessary dependencies from Maven Central, allowing for deletion of the old App Engine SDK.\u003c/p\u003e\n"]]],[],null,["# Migrate to Cloud Code for IntelliJ\n\nThis document describes how to migrate your IntelliJ-based App Engine project\nto Cloud Code for IntelliJ.\n| **Caution:** As of January 31, 2024, Java 8 support for App Engine has ended, and will be deprecated on January 31, 2026. As a result, Cloud Code disables App Engine by default. To enable App Engine in your IDE, navigate to **Settings** \\\u003e **Google\n| Cloud Code** \\\u003e **App Engine** . Due to the upcoming deprecation of App Engine, we don't recommend creating new App Engine projects. For more information about App Engine deprecations, see [Feature deprecations](/appengine/docs/standard/deprecations). For more information about the runtime support schedule for App Engine, see [Runtime support schedule](/appengine/docs/standard/lifecycle/support-schedule).\n\nBefore you begin\n----------------\n\n- If your project is Maven or Gradle based and uses the older\n App Engine SDK based plugins (e.g.\n `com.google.appengine.appengine-maven-plugin` and\n `com.google.appengine:gradle-appengine-plugin`), you should first migrate to\n the new gcloud CLI based\n [Maven](/appengine/docs/standard/java/tools/migrate-maven)\n and\n [Gradle](/appengine/docs/standard/java/tools/migrate-gradle)\n plugins.\n\n- The new plugin does not support Datanucleus enhancement. If you depend on\n this feature, you will have to manually configure Datanucleus\n ([JDO](/appengine/docs/standard/java/datastore/jdo/overview-dn2),\n [JPA](/appengine/docs/standard/java/datastore/jpa/overview-dn2))\n enhancement for your project to migrate to Cloud Code.\n You should use\n [Objectify](/appengine/docs/legacy/standard/java/datastore#using_objectify_with)\n as your ORM layer when reading/writing to Datastore.\n\nInstall the new plugin\n----------------------\n\nIf you haven't already, install the plugin by doing the following:\n\n- Ensure you have the supported IDE version, JetBrains IDE version 2022.3+ (such as IntelliJ Ultimate/Community, PyCharm Professional/Community, WebStorm, GoLand), on the `PATH` of your machine.\n- Open IntelliJ IDEA (or any supported JetBrains IDE).\n- Open the plugins marketplace window using **File** \\\u003e **Settings** \\\u003e **Plugins** . For Mac OS X, use **IntelliJ IDEA** \\\u003e **Preferences** \\\u003e **Plugins**.\n- Search for the 'Cloud Code' plugin and install it.\n\n You may be prompted to restart your IDE to activate the plugin.\n\nConfigure IntelliJ and your project\n-----------------------------------\n\nAfter installing the plugin, configure IntelliJ and your project to use the new\nplugin as follows:\n\n1. When notified that the new plugin conflicts with the existing\n App Engine integration, click the link in the prompt.\n\n2. In the following Disable Plugin prompt, select 'Disable and Restart' to\n disable the App Engine plugin and restart the IDE for the plugin\n configuration changes to take effect.\n\n3. When notified that your project is in an old format, click the option to\n **Convert** your project to the new format.\n\n4. You should delete your existing App Engine Server and Cloud\n instances and recreate them using the new gcloud CLI.\n\n 1. Navigate to **Settings** \\\u003e **Build, Execution, Deployment** \\\u003e\n **Application Servers**.\n\n 2. Select your **App Engine Dev** instances and click\n **Delete** (-).\n\n 3. Click **Add** (+) and select **Google App Engine Dev Server**.\n\n 4. Navigate to **Settings** \\\u003e **Build, Execution, Deployment** \\\u003e\n **Clouds**.\n\n 5. Select your **Google App Engine** cloud instances and click\n **Delete** (-).\n\n 6. Click **Add** (+) to configure an App Engine cloud deployment\n target.\n\n5. If you have any App Engine local server run configurations, then\n you must update them to use the newly configured Application Server.\n\n6. Navigate to **Tools** \\\u003e **Cloud Code** \\\u003e **App Engine** to see the list of actions\n available to you for running and deploying your application, or view\n [the documentation](/code/docs/intellij/how-to) for more information.\n\n7. For Maven or Gradle-based projects, ensure that you are using the latest\n version of the Gradle and Maven App Engine plugins.\n\nConfiguring IntelliJ-specific projects\n--------------------------------------\n\nFor IntelliJ-specific projects only (i.e., projects that have manually configured\nproject settings with the old App Engine facet and are not synced from\nGradle or Maven), update your App Engine dependencies.\n\nYour App Engine dependencies are still configured as\n'External Libraries' and provided by your old App Engine SDK\ninstallation. If you delete your App EngineSDK installation, your\napplication will not compile.\n\nTo remove this dependency on the old App Engine SDK, configure your\nApp Engine API dependencies using the App Engine Facet\nlibrary import feature as follows:\n\n1. Users of the old plugin's Datanucleus JDO/JPA enhancement feature need to\n port their applications to Maven or Gradle as Datanucleus enhancement is not\n supported by the Cloud Code plugin.\n\n2. From the IntelliJ Project Structure UI, navigate to your App Engine\n Standard module's dependencies tab.\n\n3. Remove all App Engine related libraries.\n\n4. In the same Project Structure UI, navigate to your App Engine\n module's **Google App Engine** facet.\n\n5. In the **Libraries** panel, select the App Engine dependencies you\n are using.\n\n This action will automatically retrieve these dependencies from Maven\n Central and add them to your module classpath.\n6. Run locally and deploy to verify your new configuration is working.\n\n7. At this point, you can safely delete your old App Engine SDK.\n\nGet support\n-----------\n\nTo submit feedback or report an issue in your IntelliJ IDE, go to **Tools** \\\u003e **Cloud Code** \\\u003e **Help / About** \\\u003e **Submit\nfeedback or report an issue** to report an issue on [GitHub](https://github.com/GoogleCloudPlatform/cloud-code-intellij/issues)."]]
