Bermigrasi dari Google Plugin for Eclipse

Catatan: Cloud Tools for Eclipse hanya kompatibel dengan runtime Java 8 App Engine, yang akan mencapai penghentian dukungan pada 31 Januari 2024. Setelah tanggal ini, aplikasi Java 8 yang ada akan terus berjalan dan menerima traffic. Namun, Anda tidak dapat men-deploy aplikasi baru atau mengupdate aplikasi yang ada yang menggunakan runtime setelah tanggal akhir dukungannya. Sebaiknya migrasikan ke versi Java terbaru yang didukung.

Plugin Google untuk Eclipse (GPE) tidak lagi tersedia. Dokumen ini menjelaskan cara memigrasikan project yang menggunakan GPE ke Cloud Tools for Eclipse.

App Engine Standard

Cloud Tools for Eclipse mendukung pengembangan untuk lingkungan App Engine. Untuk memigrasikan project GPE yang ada ke Cloud Tools for Eclipse:

1. Pastikan Anda menjalankan Eclipse IDE untuk Developer Java EE, versi 4.8 hingga 4.21.

2. Instal Cloud Tools for Eclipse. Proses ini akan meng-uninstal GPE.

3. Buka Project Explorer di Eclipse.

4. Klik kanan project yang ingin dikonversi, lalu pilih Konfigurasi > Konversi ke Project App Engine.

Apps Script

Anda dapat mengedit project Apps Script langsung di browser web menggunakan editor skrip Google Drive.

Semua project Apps Script Anda sudah tersedia di Google Drive, tanpa ekspor atau konversi tambahan.

GWT

Instal plugin Eclipse GWT.

Anda mungkin melihat error build di project GWT. Untuk mengatasinya:

1. Pilih Project di Project Explorer.

2. Buka menu konteks.

3. Pilih Configure > Enable GWT SDM builder.

App Engine + GWT

Kode App Engine berjalan di server, dan kode GWT berjalan di klien, meskipun dikompilasi dan ditayangkan dari server. Idealnya, Anda harus membaginya menjadi project terpisah: project Eclipse App Engine dan project Eclipse GWT.

Setelah melakukannya, Anda dapat mengikuti langkah-langkah migrasi standar App Engine dan langkah-langkah migrasi project GWT, seperti yang dijelaskan di atas.

Android

Android Studio adalah IDE resmi untuk pengembangan Android.

Anda dapat mengonversi project Android Eclipse yang ada menjadi project Android Studio dengan file build berbasis Gradle menggunakan prosedur untuk bermigrasi dari Eclipse.

Endpoint

GPE mendukung Endpoints v1. Sebaiknya upgrade ke Endpoints v2. Tidak ada yang khusus untuk IDE terkait upgrade ini.

Tidak ada IDE, termasuk Eclipse, yang saat ini menyediakan dukungan terintegrasi untuk Endpoint v2. Anda dapat menggunakan project Endpoints v2 di Eclipse, seperti yang Anda lakukan dengan project Java lainnya. Namun, tidak ada pemeriksaan kode khusus Endpoints, generator kode, wizard project baru, editor, atau alat deployment.

Jika ingin terus menggunakan Endpoints v1, Anda juga dapat mengimpor project backend ke Eclipse seperti project Java lainnya. Pendekatan paling sederhana untuk menggunakan Endpoints v1 tanpa GPE adalah dengan memanfaatkan com.google.appengine:appengine-maven-plugin dan integrasi Eclipse m2e.

Jika project Anda belum di-build dengan maven, Anda perlu menambahkan file pom.xml:

1. Jika perlu, instal plugin m2e.

2. Pilih project di Project Explorer.

3. Dari menu konteks, pilih Configure > Convert to Maven Project. Konversi ini menambahkan file pom.xml ke project dan menetapkan project untuk menggunakan builder Maven.

4. Tambahkan dependencies berikut ke pom.xml tersebut:

   <dependencies>
     <dependency>
       <groupId>com.google.appengine</groupId>
       <artifactId>appengine-endpoints</artifactId>
       <version>1.9.73</version>
     </dependency>
     <dependency>
       <groupId>org.eclipse.persistence</groupId>
       <artifactId>javax.persistence</artifactId>
       <version>2.1.0</version>
     </dependency>
     <dependency>
       <groupId>javax.inject</groupId>
       <artifactId>javax.inject</artifactId>
       <version>1</version>
     </dependency>
     <dependency>
       <groupId>javax.servlet</groupId>
       <artifactId>javax.servlet-api</artifactId>
       <version>3.1.0</version>
     </dependency>
     <dependency>
       <groupId>com.google.code.findbugs</groupId>
       <artifactId>jsr305</artifactId>
       <version>3.0.2</version>
     </dependency>
     <dependency>
       <groupId>com.google.appengine.orm</groupId>
       <artifactId>datanucleus-appengine</artifactId>
       <version>2.1.2</version>
     </dependency>
   </dependencies>
   

   Jika aplikasi Anda bergantung pada library lain, tambahkan juga dependensi tersebut.

5. Tambahkan plugin ini ke bagian plugins:

   <plugin>
       <groupId>com.google.cloud.tools</groupId>
       <artifactId>endpoints-framework-maven-plugin</artifactId>
       <version>1.0.0</version>
   </plugin>
   

6. Setelah pom.xml disiapkan, gunakan sasaran endpoints-framework:discoveryDocs untuk membuat dokumen penemuan:

   $ mvn endpoints-framework:discoveryDocs
   

7. Gunakan sasaran endpoints-framework:clientLibs untuk membuat library klien:

   $ mvn endpoints-framework:clientLibs
   

Anda dapat memetakan sasaran ini ke konfigurasi run Maven Build Eclipse untuk memudahkan akses dari menu Run.

DataNucleus (JPA & JDO)

Cloud Tools for Eclipse tidak meningkatkan kualitas class entity secara otomatis.

Anda dapat menggunakan Maven untuk fungsi ini.

Objectify

Alur kerja pengembangan di Cloud Tools for Eclipse mendukung Objectify 5.x tanpa perubahan.

Jika mau, Anda dapat bermigrasi ke Objectify 6.0. Migrasi ini memerlukan update pada kode project Anda. Pengembangan lokal dengan Objectify 6.0 juga memerlukan emulator Datastore (gcloud beta emulators datastore), yang harus diluncurkan di luar Eclipse dan memerlukan beberapa konfigurasi tambahan untuk peluncuran Anda.

Lihat dokumentasi Objectify untuk mengetahui informasi selengkapnya.

Langkah Berikutnya

• Setelah berhasil memigrasikan project ke Cloud Tools for Eclipse, pelajari lebih lanjut alat dan referensi yang tersedia.

• Pelajari kode plugin atau laporkan masalah di GitHub, atau ajukan pertanyaan di Stack Overflow.