Mulai Menggunakan Library Klien .NET
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Jeff Fisher, tim Google Data API
Agustus 2007
Pengantar
Gambar 1: Solusi Google Data API
Bagi banyak developer, bagian tersulit dari project baru adalah memulai prosesnya, yaitu 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. Kami berharap hal ini dapat menghemat waktu Anda saat memulai dan memungkinkan Anda mulai bekerja dengan beberapa kode dengan cepat.
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
- Download rilis MSI terbaru library klien dari http://code.google.com/p/google-gdata/downloads/list.
- Jalankan file MSI yang didownload untuk menginstal paket. Secara default, SDK akan diinstal ke "C:\Program Files\Google\Google Data API SDK\". Contoh lebih lanjut dalam artikel ini akan mengasumsikan Anda telah menginstal library klien ke lokasi ini.
- Buka file solusi bernama "Google Data API SDK" di folder "Google Data API SDK" di Menu Start.
Mengompilasi dan menjalankan contoh
- Pastikan bahwa menjalankan "Build > Build Solution" selesai tanpa error.
- Untuk membuat build Debug, buka "Build > Configuration Manager" dan pilih "Debug" sebagai konfigurasi solusi aktif. Kemudian, pilih "Build > Build Solution".
- File biner dan 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 Start ke sampel ini.
Mengembangkan aplikasi Anda sendiri
Jika Anda ingin mengembangkan project di luar file solusi yang disediakan oleh file MSI, Anda harus menambahkan file DLL library klien sebagai jalur referensi.
- Buat atau buka project di luar solusi SDK API Google.
- Pilih "Add Reference" dari menu Project.
- Klik tab Jelajahi.
- Buka direktori Redist di SDK: "C:\Program Files\Google\Google Data API SDK\Redist".
- Pilih file DLL yang akan digunakan oleh kode Anda. Google.GData.Extensions.dll dan Google.GData.Client.dll akan diperlukan untuk sebagian besar project, bersama dengan file DLL khusus untuk layanan Google yang Anda gunakan di aplikasi Anda.
Catatan: Ada juga file solusi untuk library klien di perangkat Seluler. File ini 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 bahwa pengujian NUnit yang sesuai berhasil adalah langkah penting jika Anda membuat perubahan pada library klien atau berencana untuk berkontribusi pada library tersebut. Jika Anda berencana menggunakan library klien tanpa modifikasi, biasanya tidak perlu menjalankannya.
- Download rilis file MSI .NET 2.0 NUnit dari http://www.nunit.org/index.php?p=download.
- Instal NUnit dengan menjalankan file MSI. Lokasi penginstalan default mirip dengan "C:\Program Files\NUnit 2.4.8". Anda dapat mengubahnya menjadi seperti "C:\Program Files\NUnit" sehingga Anda dapat mengupgrade NUnit di masa mendatang tanpa harus mengubah jalur di project Visual Studio Anda.
- Buka direktori "C:\Program Files\Google\Google Data API SDK\Sources\Library\VS2005", lalu buka file solusi bernama "Google Data APIs".
Anda akan melihat Conversion Wizard karena ini adalah file project Visual Studio 2005. Klik petunjuk atau cukup klik tombol "Selesai". Log konversi akan ditampilkan, yang dapat diabaikan.
- Sekarang NUnit harus ditambahkan sebagai jalur referensi. Klik kanan project "unittests" di Solution Explorer di sebelah kanan, lalu pilih "Properties". Sekarang klik tab "Reference Paths" di jendela yang terbuka. Masukkan lokasi subdirektori "bin" dari penginstalan NUnit sebagai jalur referensi, lalu klik "Add Folder". Misalnya, jika NUnit diinstal ke "C:\Program Files\NUnit\", Anda harus memasukkan "C:\Program Files\NUnit\bin". Pastikan untuk menyimpan perubahan ini sebelum melanjutkan.
- Ikuti langkah-langkah yang tercantum dalam Mengompilasi dan menjalankan contoh untuk membangun kembali library klien dan pengujian unit.
- 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 untuk mengedit file agar menyertakan informasi yang sesuai untuk pengujian yang Anda jalankan. Misalnya, Base memerlukan kunci API dan Calendar memerlukan nama pengguna dan sandi. Sebaiknya gunakan akun pengujian tanpa data aktif untuk menghindari penghapusan informasi oleh pengujian unit.
- Buka NUnit dari Menu Start.
- Buka "File > Open Project" dan pilih file "unittests.dll" dari "C:\Program Files\Google\Google Data API SDK\Source\Library\VS2005\unittests\bin\Debug\".
- Jalankan pengujian unit yang Anda inginkan. Ingatlah bahwa pengujian tertentu memerlukan parameter yang ditetapkan di unittests.dll.config agar dapat berfungsi. Jika Anda menjalankan uji beban untuk layanan tertentu, akun pengujian Anda mungkin ditandai sebagai menghasilkan spam dan tidak dapat mengirimkan konten ke server Google secara terprogram tanpa menghadapi 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 kami untuk developer yang ingin mengerjakan salah satu platform ini.
Menyiapkan lingkungan Anda
- Download rilis file ZIP terbaru library klien dari http://code.google.com/p/google-gdata/downloads/list
- Ekstrak ke direktori lokal (misalnya, "/scratch/gdata.NET")
- Gunakan pengelolaan paket distribusi Anda untuk menginstal Mono.
Atau, Anda dapat mendownloadnya dari http://www.mono-project.com.
- Di beberapa distribusi, Anda harus memastikan bahwa file nunit.framework.dll ditautkan dengan benar ke dalam 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.dll").
Mengompilasi dan menjalankan contoh
- Dengan asumsi Anda menginstal library klien ke "/scratch/gdata.NET", ubah ke direktori "/scratch/gdata.NET/clients/cs".
- Edit Makefile bergantung pada versi .NET yang ingin Anda gunakan. Untuk .NET 1.x, gunakan
CSC=mcs dan untuk .NET 2.x, gunakan CSC=gmcs.
- Jalankan
make untuk mengompilasi library dan contoh aplikasi.
- Jalankan
make install jika Anda ingin menginstal DLL library klien ke library Mono.
Mengembangkan aplikasi Anda sendiri
Jika Anda 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# bersama dengan referensi ke file DLL dari ekstensi layanan tertentu yang ingin Anda gunakan.
Menjalankan pengujian NUnit
- Salin file unittests.dll.config dari "/scratch/gdata.NET/clients/cs/src/unittests" ke "/scratch/gdata.NET/clients/cs/".
- Edit "/scratch/gdata.NET/clients/cs/unittests.dll.config" untuk menyertakan informasi yang sesuai untuk pengujian yang Anda jalankan. Misalnya, Base memerlukan kunci API dan Calendar memerlukan nama pengguna dan sandi. Sebaiknya gunakan akun pengujian tanpa data aktif untuk menghindari penghapusan informasi oleh pengujian unit.
- 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 baru permulaan. Sebaiknya Anda membaca dokumentasi yang ada di direktori ".../clients/cs/docs" pada library klien.
Anda juga dapat melihat Panduan Developer Library Klien.NET, halaman project dan panduan referensi, serta forum library klien .NET Google Data.
Alat yang dirujuk dalam artikel ini:
Semoga berhasil dengan aplikasi .NET Anda berikutnya.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-27 UTC.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-07-27 UTC."],[[["\u003cp\u003eThis guide provides step-by-step instructions for setting up and using the Google Data .NET client library with either Visual Studio 2008 or Mono.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can use this library to interact with various Google services like Calendar by compiling and running provided sample applications or by developing their own applications.\u003c/p\u003e\n"],["\u003cp\u003eThe guide includes details on compiling the library, running provided unit tests for verifying functionality, and configuring the development environment for both Windows and Unix-based systems.\u003c/p\u003e\n"],["\u003cp\u003eAdditional resources such as the .NET Client Library Developer's Guide and project forums are available for further assistance.\u003c/p\u003e\n"]]],[],null,["# Getting Started with the .NET Client Library\n\n*Jeff Fisher, Google Data APIs team\nAugust 2007*\n\n- [Introduction](#introduction)\n- [Visual Studio 2008](#vs2005)\n - [Setting up your environment](#vssetup)\n - [Compiling and running samples](#vscompile)\n - [Developing your own application](#vsdevelop)\n - [Running the NUnit tests](#vsnunit)\n- [Mono](#mono)\n - [Setting up your environment](#monosetup)\n - [Compiling and running samples](#monocompile)\n - [Developing your own application](#monodevelop)\n - [Running the NUnit tests](#mononunit)\n- [Conclusion](#conclusion)\n\n### Introduction\n\n\u003cbr /\u003e\n\n**Figure 1: The Google Data API solution**\n\nFor many developers, the most difficult part of a new project is getting the ball rolling-installing new software packages, configuring a development environment, and learning new libraries. In this article, I have pulled together some step-by-step instructions for how to begin with the .NET client library using either Visual Studio 2005 for Windows or Mono for Linux and other Unix operating systems. It is my hope that this will save you some time in getting started and let you quickly start working with some code.\n\nVisual Studio 2008\n------------------\n\nIf you do not already have Visual Studio 2008 installed, you may want to consider using [Visual C# 2008 Express Edition](http://msdn.microsoft.com/en-us/library/orm-9780596521066-01-02.aspx), a free version of Visual Studio that will allow you to work with the .NET client library.\n\n### Setting up your environment\n\n1. Download the latest MSI release of the client library from [http://code.google.com/p/google-gdata/downloads/list](//code.google.com/p/google-gdata/downloads/list).\n2. Run the downloaded MSI file to install the package. It will install to \"C:\\\\Program Files\\\\Google\\\\Google Data API SDK\\\\\" by default. Further examples in this article will assume you installed the client library to this location.\n3. Open the solution file called \"Google Data API SDK\" in the \"Google Data API SDK\" folder in the Start Menu.\n\n### Compiling and running samples\n\n1. Verify that running \"Build \\\u003e Build Solution\" completes without any errors.\n2. To create a Debug build go to \"Build \\\u003e Configuration Manager\" and select \"Debug\" as the active solution configuration. Then select \"Build \\\u003e Build Solution\".\n3. The binaries and DLL files you have just compiled can be found in \"C:\\\\Program Files\\\\Google\\\\Google Data API SDK\\\\Sources\\\\Samples\\\\\" For example, you can run the sample application for Calendar by executing \"C:\\\\Program Files\\\\Google\\\\Google Data API SDK\\\\Sources\\\\Samples\\\\calendar\\\\bin\\\\Debug\\\\Calendar.exe\". There are also some Start Menu shortcuts to these samples.\n\n### Developing your own application\n\nIf you want to develop in a project outside of the solution file provided by the MSI file, you need to add the client library DLL files as a reference path.\n\n1. Create or open a project outside of the Google API SDK solution.\n2. Select \"Add Reference\" from the Project menu.\n3. Click on the Browse tab.\n4. Navigate to the Redist directory in the SDK: \"C:\\\\Program Files\\\\Google\\\\Google Data API SDK\\\\Redist\".\n5. Select the DLL files that will be used by your code. Google.GData.Extensions.dll and Google.GData.Client.dll will be needed for most projects, along with the DLL file specific to the Google service(s) you are using in your application.\n\n**Note:** There is also a solution file for client libraries on Mobile devices. It is found in \"C:\\\\Program Files\\\\Google\\\\Google Data API SDK\\\\Sources\\\\Library\\\\VS2005.mobile\" by default. This solution will only compile the DLL files for the client libraries.\n\n### Running the NUnit tests\n\nMaking sure the appropriate NUnit tests pass is an important step if you make any changes to the client libraries or plan to contribute to them. If you plan to use the client libraries without modifications then there is normally no need to run them.\n\n1. Download the .NET 2.0 MSI file release of NUnit from \u003chttp://www.nunit.org/index.php?p=download\u003e.\n2. Install NUnit by running the MSI file. The default install location is similar to \"C:\\\\Program Files\\\\NUnit 2.4.8\". You may wish to change this to something like \"C:\\\\Program Files\\\\NUnit\" so you can upgrade NUnit in the future without having to change the path in your Visual Studio project.\n3. Go to the \"C:\\\\Program Files\\\\Google\\\\Google Data API SDK\\\\Sources\\\\Library\\\\VS2005\" directory and open the solution file named \"Google Data APIs\". You will see the Conversion Wizard since this is a Visual Studio 2005 project file. Either click through the prompts or simply click on the \"Finish\" button. It should display the conversion log, which can be ignored.\n4. Now NUnit must be added as a reference path. Right click on the \"unittests\" project in the Solution Explorer on the right and select \"Properties\". Now click on the \"Reference Paths\" tab within the window that opens. Enter in the location of the \"bin\" subdirectory of the NUnit installation as a reference path and click \"Add Folder\". For example, if NUnit is installed to \"C:\\\\Program Files\\\\NUnit\\\\\", one would enter \"C:\\\\Program Files\\\\NUnit\\\\bin\". Be sure to save this change before continuing.\n5. Follow the steps listed in [Compiling and running samples](#vscompile) to rebuild the client library and the unit tests.\n6. Copy the \"unittests.dll.config\" file in \"C:\\\\Program Files\\\\Google\\\\Google Data API SDK\\\\Sources\\\\Library\\\\unittests\\\\\" to your debug build directory \"C:\\\\Program Files\\\\Google\\\\Google Data API SDK\\\\Source\\\\Library\\\\VS2005\\\\unittests\\\\bin\\\\Debug\\\\\". Remember to edit the file to include the appropriate information for the tests you are running. For example, Base requires an API key and Calendar requires a username and password. It is recommended to use a test account without any live data to avoid having information deleted by the unit tests.\n7. Open NUnit from the Start Menu.\n8. Go to \"File \\\u003e Open Project\" and select the \"unittests.dll\" file from \"C:\\\\Program Files\\\\Google\\\\Google Data API SDK\\\\Source\\\\Library\\\\VS2005\\\\unittests\\\\bin\\\\Debug\\\\\".\n9. Run the unit tests you are interested in. Remember that certain tests require parameters be set in unittests.dll.config to work. If you run the stress tests for certain services you may have your test account flagged as generating spam and be unable to programmatically submit content to Google servers without encountering CAPTCHA challenges.\n\nMono\n----\n\nMono is an open source project that allows you to run .NET client and server applications on Linux, Solaris, Mac OS X, Windows, and Unix. We offer a separate ZIP file of our client library for developers who want to work on one of these platforms.\n\n### Setting up your environment\n\n1. Download the latest ZIP file release of the client library from [http://code.google.com/p/google-gdata/downloads/list](//code.google.com/p/google-gdata/downloads/list)\n2. Extract to a local directory (e.g. \"/scratch/gdata.NET\")\n3. Use your distribution's package management to install Mono. Alternatively, you can download it from \u003chttp://www.mono-project.com\u003e.\n4. In some distributions you have to make sure that the nunit.framework.dll file is properly linked into the mono library. If mono was installed to \"/usr/lib/mono\", then ensure that there are symbolic links in \"/usr/lib/mono/1.0\" and \"/usr/lib/mono/2.0\" for nunit.framework.dll (which should be installed in \"/usr/lib/mono/gac/nunit.framework/\\\u003csomeversionstring\\\u003e/nunit.framework.dll\").\n\n### Compiling and running samples\n\n1. Assuming you installed the client library to \"/scratch/gdata.NET\", change to the \"/scratch/gdata.NET/clients/cs\" directory.\n2. Edit the Makefile depending on what version of .NET you wish to use. For .NET 1.x, use `CSC=mcs` and for .NET 2.x, use `CSC=gmcs`.\n3. Run `make` to compile the libraries and sample applications.\n4. Execute `make install` if you want to install the client library DLLs into the Mono library.\n\n### Developing your own application\n\nIf you executed a `make install` after compiling the client library, you should be able to include the libraries in your own code by passing `-r:Google.GData.Extensions.dll -r:Google.GData.Client.dll` to the Mono C# compiler along with references to the DLL files of any specific service extensions you wish to use.\n\n### Running the NUnit tests\n\n1. Copy the unittests.dll.config file from \"/scratch/gdata.NET/clients/cs/src/unittests\" to \"/scratch/gdata.NET/clients/cs/\".\n2. Edit \"/scratch/gdata.NET/clients/cs/unittests.dll.config\" to include the appropriate information for the tests you are running. For example, Base requires an API key and Calendar requires a username and password. I recommend using a test account without any live data to avoid having information deleted by the unit tests.\n3. After compiling the library there will be a unittests.dll file in \"/scratch/gdata.NET/clients/cs\". Use this DLL with your NUnit test manager of choice (nunit-console, gnunit, etc.).\n\n### Conclusion\n\nNow you should be able to compile the libraries and run the sample code. This is only the beginning, however. I encourage you to read through the documentation found in the \".../clients/cs/docs\" directory of the client library.\nYou might also want to check out the [.NET Client Library Developer's Guide](/gdata/client-cs), the [project page](http://code.google.com/p/google-gdata/) and [reference guide](http://google-gdata.googlecode.com/svn/docs/Index.html), and the [Google Data .NET client library forum](http://groups.google.com/group/gdata-dotnet-client-library).\n\nTools referenced in this article:\n\n- [Mono Project](http://www.mono-project.com/Main_Page)\n- [Visual Studio](http://msdn2.microsoft.com/en-us/vstudio/default.aspx)\n- [Visual C# 2008 Express Edition](http://msdn.microsoft.com/en-us/library/orm-9780596521066-01-02.aspx)\n- [NUnit](http://www.nunit.org/)\n\nGood luck on your next .NET application!"]]
