Mulai Menggunakan Library Klien .NET

Jeff Fisher, tim Google Data API
Agustus 2007

Pengantar

Solusi Google Data API
Gambar 1: Solusi Google Data API

Bagi banyak developer, bagian tersulit dari sebuah project baru adalah membuat mereka menginstal paket software baru, mengonfigurasi lingkungan pengembangan, dan mempelajari library baru. Dalam artikel ini, saya telah mengumpulkan beberapa petunjuk langkah demi langkah tentang cara memulai library klien .NET menggunakan Visual Studio 2005 untuk Windows atau Mono untuk Linux dan sistem operasi Unix lainnya. Semoga ini akan menghemat waktu Anda dalam memulai dan memungkinkan Anda mulai bekerja dengan cepat dengan beberapa kode.

Visual Studio 2008

Jika belum menginstal Visual Studio 2008, Anda dapat mempertimbangkan untuk menggunakan Visual C# 2008 Express Edition, versi gratis Visual Studio yang memungkinkan Anda menggunakan library klien .NET.

Menyiapkan lingkungan Anda

  1. Download rilis library klien MSI terbaru dari http://code.google.com/p/google-gdata/downloads/list.
  2. Jalankan file MSI yang didownload untuk menginstal paket. File akan diinstal ke "C:\Program Files\Google\Google Data API SDK\" secara default. Contoh lebih lanjut dalam artikel ini akan mengasumsikan bahwa Anda menginstal library klien ke lokasi ini.
  3. Buka file solusi bernama "Google Data API SDK" di folder "Google Data API SDK" di Menu Mulai.

Mengompilasi dan menjalankan sampel

  1. Verifikasi bahwa menjalankan "Build > Build Solution" selesai tanpa error.
  2. Untuk membuat build Debug, buka "Build > Configuration Manager" dan pilih "Debug" sebagai konfigurasi solusi aktif. Lalu pilih "Build > Build Solution".
  3. Biner dan file DLL yang baru saja Anda kompilasi dapat ditemukan di "C:\Program Files\Google\Google Data API SDK\Sources\Samples\" Misalnya, Anda dapat menjalankan aplikasi contoh untuk Kalender dengan menjalankan "C:\Program Files\Google\Google Data API SDK\Sources\Samples\calendar\bin\Debug\Calendar.exe". Ada juga beberapa pintasan Menu Mulai untuk contoh ini.

Mengembangkan aplikasi Anda sendiri

Jika ingin mengembangkan dalam project di luar file solusi yang disediakan oleh file MSI, Anda perlu menambahkan file DLL library klien sebagai jalur referensi.

  1. Buat atau buka project di luar solusi SDK Google API.
  2. Pilih "Tambahkan Referensi" dari menu Project.
  3. Klik tab Cari.
  4. Buka direktori Redist di SDK: "C:\Program Files\Google\Google Data API SDK\Redist".
  5. Pilih file DLL yang akan digunakan oleh kode Anda. Google.GData.Extensions.dll dan Google.GData.Client.dll akan diperlukan untuk sebagian besar project, beserta file DLL khusus untuk layanan Google yang Anda gunakan dalam aplikasi Anda.

Catatan: Ada juga file solusi untuk library klien di perangkat Seluler. File ini dapat ditemukan di "C:\Program Files\Google\Google Data API SDK\Sources\Library\VS2005.mobile" secara default. Solusi ini hanya akan mengompilasi file DLL untuk library klien.

Menjalankan pengujian NUnit

Memastikan pengujian NUnit yang sesuai berhasil adalah langkah penting jika Anda membuat perubahan pada library klien atau berencana untuk berkontribusi. Jika Anda berencana menggunakan library klien tanpa modifikasi, biasanya Anda tidak perlu menjalankannya.

  1. Download rilis file NUnit .NET 2.0 dari http://www.nunit.org/index.php?p=download.
  2. Instal NUnit dengan menjalankan file MSI. Lokasi penginstalan default mirip dengan "C:\Program Files\NUnit 2.4.8". Anda dapat mengubahnya menjadi sesuatu seperti "C:\Program Files\NUnit" agar Anda dapat mengupgrade NUnit pada masa mendatang tanpa harus mengubah jalur dalam project Visual Studio.
  3. Buka direktori "C:\Program Files\Google\Google Data API SDK\Sources\Library\VS2005" dan buka file solusi bernama "Google Data API". Anda akan melihat Wizard Konversi karena ini adalah file project Visual Studio 2005. Klik perintah atau cukup klik tombol "Selesai". Tag konversi akan ditampilkan, yang dapat diabaikan.
  4. Sekarang NUnit harus ditambahkan sebagai jalur referensi. Klik kanan project "unittests" di Solution Explorer di sebelah kanan, lalu pilih "Properties". Sekarang klik tab "Jalur Referensi" dalam jendela yang terbuka. Masukkan di lokasi subdirektori "bin" dari penginstalan NUnit sebagai jalur referensi, lalu klik "Add Folder". Misalnya, jika NUnit diinstal ke "C:\Program Files\NUnit\", seseorang harus memasukkan "C:\Program Files\NUnit\bin". Pastikan untuk menyimpan perubahan ini sebelum melanjutkan.
  5. Ikuti langkah-langkah yang tercantum dalam Mengompilasi dan menjalankan contoh untuk mem-build ulang library klien dan pengujian unit.
  6. Salin file "unittests.dll.config" di "C:\Program Files\Google\Google Data API SDK\Sources\Library\unittests\" ke direktori build debug Anda "C:\Program Files\Google\Google Data API SDK\Source\Library\VS2005\unittests\bin\Debug\". Jangan lupa mengedit file untuk menyertakan informasi yang sesuai untuk pengujian yang Anda jalankan. Misalnya, Basis memerlukan kunci API dan Kalender memerlukan nama pengguna dan sandi. Sebaiknya gunakan akun pengujian tanpa data langsung untuk menghindari informasi dihapus oleh pengujian unit.
  7. Buka NUnit dari Menu Start.
  8. Buka "File > Open Project" dan pilih file "unittests.dll" dari "C:\Program Files\Google\Google Data API SDK\Source\Library\VS2005\unittests\bin\Debug\".
  9. Jalankan pengujian unit yang Anda minati. Ingat bahwa pengujian tertentu memerlukan parameter yang ditetapkan di unittests.dll.config agar berfungsi. Jika Anda menjalankan tes stres untuk layanan tertentu, akun pengujian Anda mungkin ditandai sebagai menghasilkan spam dan tidak dapat mengirimkan konten secara terprogram ke server Google tanpa mengalami tantangan CAPTCHA.

Mono

Mono adalah project open source yang memungkinkan Anda menjalankan aplikasi klien dan server .NET di Linux, Solaris, Mac OS X, Windows, dan Unix. Kami menawarkan file ZIP terpisah dari library klien untuk developer yang ingin menggunakan salah satu platform ini.

Menyiapkan lingkungan Anda

  1. Download rilis file ZIP terbaru library klien dari http://code.google.com/p/google-gdata/downloads/list
  2. Mengekstrak ke direktori lokal (misalnya, "/scratch/gdata.NET")
  3. Gunakan pengelolaan paket distribusi untuk menginstal Mono. Atau, Anda dapat mendownloadnya dari http://www.mono-project.com.
  4. Di beberapa distribusi, Anda harus memastikan bahwa file nunit.framework.dll ditautkan dengan benar ke library mono. Jika mono diinstal ke "/usr/lib/mono", pastikan ada link simbolis di "/usr/lib/mono/1.0" dan "/usr/lib/mono/2.0" untuk nunit.framework.dll (yang harus diinstal di "/usr/lib/mono/gac/nunit.framework/<someversionstring>/nunit.framework.d").

Mengompilasi dan menjalankan sampel

  1. Dengan asumsi Anda telah menginstal library klien ke "/scratch/gdata.NET", ubah ke direktori "/scratch/gdata.NET/clients/cs".
  2. Edit Makefile bergantung pada versi .NET yang ingin digunakan. Untuk .NET 1.x, gunakan CSC=mcs dan untuk .NET 2.x, gunakan CSC=gmcs.
  3. Jalankan make untuk mengompilasi library dan aplikasi contoh.
  4. Jalankan make install jika Anda ingin menginstal DLL library klien ke library Mono.

Mengembangkan aplikasi Anda sendiri

Jika menjalankan make install setelah mengompilasi library klien, Anda akan dapat menyertakan library dalam kode Anda sendiri dengan meneruskan -r:Google.GData.Extensions.dll -r:Google.GData.Client.dll ke compiler Mono C# beserta referensi ke file DLL dari ekstensi layanan tertentu yang ingin Anda gunakan.

Menjalankan pengujian NUnit

  1. Salin file unittests.dll.config dari "/scratch/gdata.NET/clients/cs/src/unittests" ke "/scratch/gdata.NET/clients/cs/".
  2. Edit "/scratch/gdata.NET/clients/cs/unittests.dll.config" untuk menyertakan informasi yang sesuai untuk pengujian yang Anda jalankan. Misalnya, Basis memerlukan kunci API dan Kalender memerlukan nama pengguna dan sandi. Sebaiknya gunakan akun pengujian tanpa data langsung untuk menghindari informasi dihapus oleh pengujian unit.
  3. Setelah mengompilasi library, akan ada file unittests.dll di "/scratch/gdata.NET/clients/cs". Gunakan DLL ini dengan pengelola pengujian NUnit pilihan Anda (nunit-console, gnunit, dll.).

Kesimpulan

Sekarang, Anda dapat mengompilasi library dan menjalankan kode contoh. Namun, ini hanyalah permulaan. Sebaiknya Anda membaca dokumentasi yang ada di direktori ".../clients/cs/docs" library klien. Sebaiknya Anda juga membaca Panduan Developer Library Klien.NET, halaman project dan panduan referensi, serta forum library klien .NET Data Google.

Alat yang dirujuk dalam artikel ini:

Semoga berhasil pada aplikasi .NET Anda berikutnya!