Cloud Tools for IntelliJ への移行

このドキュメントでは、IntelliJ ベースの App Engine プロジェクトを Cloud Tools for IntelliJ に移行する方法について説明します。

始める前に

  • Maven または Gradle ベースのプロジェクトで、古い App Engine SDK ベースのプラグイン(com.google.appengine.appengine-maven-plugincom.google.appengine:gradle-appengine-plugin など)を使っている場合は、最初に新しい Cloud SDK ベースの MavenGradle のプラグインに移行する必要があります。

  • 新しいプラグインは Datanucleus エンハンスメントに対応していません。この機能に依存している場合は、プロジェクトの Datanucleus(JDOJPA)エンハンスメントを手動で構成して Cloud Tools for IntelliJ に移行する必要があります。Cloud Datastore への読み込みや書き込みを行うときは、ORM レイヤとして Objectify を使用する必要があります。

新規プラグインのインストール

プラグインのインストールは、次のようにします。

  1. From inside IDEA, open File > Settings. Or, on Mac OS X, open IntelliJ IDEA > Preferences.
  2. Select Plugins from the navigation pane and search for Cloud Code.
  3. Click Install.
  4. Choose to Restart your IDE.
  5. Configure the project JDK:
    1. Open File > Project Structure. Or on Mac OS X open IntelliJ IDEA > Project Structure.
    2. Choose Project Settings > Project.
    3. If the Project JDK is missing, click New... and choose a JDK.

IntelliJ とプロジェクトの構成

プラグインをインストールしたら、次のように、IntelliJ とプロジェクトで新しいプラグインを使用するように構成します。

  1. 新しいプラグインと既存の App Engine 統合との競合について通知されたら、プロンプトを受け入れて古いプラグインを無効にします。

    プラグインの競合を知らせる通知と、それを無効にするプロンプトのスクリーンショット

  2. IntelliJ を再起動します

  3. プロジェクトが古い形式であることが通知されたら、プロジェクトを新しい形式に変換するオプションをクリックします。

    プロジェクトが古い形式であることを知らせる通知と、それを変換するプロンプトのスクリーンショット

  4. 既存の App Engine Server インスタンスと Cloud インスタンスを削除し、新しい Cloud SDK を使用して再作成する必要があります。

    1. [Settings] > [Build, Execution, Deployment] > [Application Servers] に移動します。

    2. App Engine Dev インスタンスを選択し、[Delete](-)をクリックします。

    3. [Add](+)をクリックし、[Google App Engine Dev Server] を選択します。

      アプリサーバーのリストと、それらの削除と追加を行うアイコンのスクリーンショット

    4. [Settings] -> [Build, Execution, Deployment] -> [Clouds] に移動します。

    5. Google App Engine のクラウド インスタンスを選択し、[Delete](-)をクリックします。

    6. [Add](+)をクリックして、App Engine クラウド デプロイメント ターゲットを構成します。

      クラウド インスタンスのリストと、それらの削除と追加を行うアイコンのスクリーンショット

  5. App Engine のローカル サーバーの実行構成がある場合は、新しく構成した Application Server を使用するように更新する必要があります。

  6. [Tools] -> [Google Cloud Tools] に移動してアプリケーションの実行とデプロイに使用できるアクションのリストを確認するか、ドキュメントでより詳しい情報をご覧ください。

  7. Maven プロジェクトや Gradle-based プロジェクトの場合は、最新の Gradle プラグインと Maven App Engine プラグインを使用するようにしてください。

ネイティブ IntelliJ プロジェクトの構成

ネイティブ IntelliJ プロジェクト(古い App Engine ファセットを使って手動で構成し、Gradle や Maven からは同期していないプロジェクト)のみ、App Engine の依存関係を更新します。

App Engine の依存関係は「外部ライブラリ」として構成され、以前の App Engine SDK のインストールによって提供されます。App Engine SDK のインストールを削除すると、アプリケーションはコンパイルされません。

外部ライブラリのリストを示すスクリーンショット

古い App Engine SDK 上にあるこの依存関係を削除するには、App Engine Facet ライブラリのインポート機能を使用して App Engine API の依存関係を次のように構成します。

  1. 古いプラグインの Datanucleus JDO / JPA エンハンスメントを使用しているユーザーは、Datanucleus エンハンスメントが Cloud Tools for IntelliJ プラグインでサポートされていないため、アプリケーションを Maven または Gradle に移植する必要があります。

  2. IntelliJ Project Structure の画面から、App Engine Standard モジュールの [dependencies] タブに移動します。

  3. App Engine の関連ライブラリをすべて削除します。

    外部ライブラリのリストと、それらの削除を行うアイコンのスクリーンショット

  4. 同じ Project Structure の画面で、App Engine モジュールの Google App Engine ファセットに移動します。

  5. [Libraries] パネルで、使用している App Engine の依存関係を選択します。

    選択可能なライブラリのリストを示すスクリーンショット。

    このアクションにより、これらの依存関係が Maven Central から自動的に取得され、モジュールのクラスパスに追加されます。

  6. ローカルで実行してデプロイし、新しい構成が機能していることを確認します。

  7. これで、古い App Engine SDK を削除しても安全です。

次のステップ

  • GitHub でプラグインのコードを調べて問題を報告します。または、Stack Overflow で質問します。
このページは役立ちましたか?評価をお願いいたします。

フィードバックを送信...

ご不明な点がありましたら、Google のサポートページをご覧ください。