Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questo documento descrive come eseguire la migrazione del progetto App Engine basato su IntelliJ
a Cloud Code for IntelliJ.
Prima di iniziare
Se il tuo progetto è basato su Maven o Gradle e utilizza i plug-in precedenti basati sull'SDK App Engine (ad es. com.google.appengine.appengine-maven-plugin e com.google.appengine:gradle-appengine-plugin), devi prima eseguire la migrazione ai nuovi plug-in Maven e Gradle basati su gcloud CLI.
Il nuovo plug-in non supporta il miglioramento di Datanucleus. Se utilizzi questa funzionalità, dovrai configurare manualmente il miglioramento di Datanucleus
(JDO,
JPA)
per il tuo progetto per eseguire la migrazione a Cloud Code.
Ti consigliamo di utilizzare
Objectify
come livello ORM per la lettura/scrittura in Datastore.
Installa il nuovo plug-in
Se non lo hai ancora fatto, installa il plug-in nel seguente modo:
Assicurati di avere la versione IDE supportata, JetBrains IDE versione 2022.3+
(come IntelliJ Ultimate/Community, PyCharm Professional/Community,
WebStorm, GoLand), sul PATH del tuo computer.
Apri IntelliJ IDEA (o qualsiasi IDE JetBrains supportato).
Apri la finestra del marketplace dei plug-in utilizzando File > Impostazioni >
Plug-in. Per Mac OS X, utilizza IntelliJ IDEA > Preferenze >
Plug-in.
Cerca il plug-in "Cloud Code" e installalo.
Per attivare il plug-in, potrebbe esserti chiesto di riavviare l'IDE.
Configura IntelliJ e il tuo progetto
Dopo aver installato il plug-in, configura IntelliJ e il tuo progetto in modo da utilizzare il nuovo
plug-in nel seguente modo:
Quando ricevi una notifica che indica che il nuovo plug-in è in conflitto con l'integrazione
App Engine esistente, fai clic sul link nel prompt.
Nel seguente prompt Disabilita plug-in, seleziona "Disabilita e riavvia" per
disabilitare il plug-in App Engine e riavviare l'IDE per rendere effettive le modifiche
alla configurazione del plug-in.
Quando ricevi una notifica che ti informa che il tuo progetto è in un formato precedente, fai clic sull'opzione per
convertire il progetto nel nuovo formato.
Devi eliminare le istanze App Engine Server e Cloud esistenti e ricrearle utilizzando la nuova gcloud CLI.
Vai a Impostazioni > Build, Execution, Deployment (Build, esecuzione, deployment) >
Application Servers (Server delle applicazioni).
Seleziona le istanze App Engine Dev e fai clic su
Elimina (-).
Fai clic su Aggiungi (+) e seleziona Google App Engine Dev Server.
Vai a Impostazioni > Build, esecuzione, deployment >
Cloud.
Seleziona le istanze cloud Google App Engine e fai clic su
Elimina (-).
Fai clic su Aggiungi (+) per configurare una destinazione di deployment cloud App Engine.
Se hai configurazioni di esecuzione del server locale App Engine, devi aggiornarle per utilizzare il server delle applicazioni appena configurato.
Vai a Strumenti > Cloud Code > App Engine per visualizzare l'elenco delle azioni
disponibili per l'esecuzione e il deployment dell'applicazione oppure visualizza
la documentazione per ulteriori informazioni.
Per i progetti basati su Maven o Gradle, assicurati di utilizzare l'ultima
versione dei plug-in Gradle e Maven App Engine.
Configurazione di progetti specifici di IntelliJ
Solo per i progetti specifici di IntelliJ (ovvero i progetti che hanno configurato manualmente
le impostazioni del progetto con il vecchio facet App Engine e non sono sincronizzati da
Gradle o Maven), aggiorna le dipendenze di App Engine.
Le dipendenze di App Engine sono ancora configurate come
"Librerie esterne" e fornite dalla vecchia installazione dell'SDK App Engine. Se elimini l'installazione di App Engine SDK, la tua
applicazione non verrà compilata.
Per rimuovere questa dipendenza dal vecchio SDK di App Engine, configura le dipendenze dell'API App Engine utilizzando la funzionalità di importazione della libreria App Engine Facet nel seguente modo:
Gli utenti della funzionalità di miglioramento JDO/JPA di Datanucleus del vecchio plug-in devono
trasferire le proprie applicazioni a Maven o Gradle, poiché il miglioramento di Datanucleus non è
supportato dal plug-in Cloud Code.
Dalla UI di IntelliJ Project Structure, vai alla scheda delle dipendenze del modulo App Engine Standard.
Rimuovi tutte le librerie correlate ad App Engine.
Nella stessa UI della struttura del progetto, vai alla sezione Google App Engine del modulo App Engine.
Nel riquadro Librerie, seleziona le dipendenze di App Engine che
stai utilizzando.
Questa azione recupererà automaticamente queste dipendenze da Maven Central e le aggiungerà al classpath del modulo.
Esegui localmente il deployment per verificare che la nuova configurazione funzioni.
A questo punto, puoi eliminare in tutta sicurezza il vecchio SDK App Engine.
Assistenza
Per inviare un feedback o segnalare un problema nel tuo IDE IntelliJ, vai a
Strumenti > Cloud Code > Guida / Informazioni > Invia
feedback o segnala un problema per segnalare un problema su GitHub.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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)."]]
