.NET 클라이언트 라이브러리 시작하기

Jeff Fisher, Google 데이터 API팀
2007년 8월

소개

Google Data API 솔루션
그림 1: Google Data API 솔루션

많은 개발자에게 새 프로젝트에서 가장 어려운 부분은 새 소프트웨어 패키지를 설치, 개발 환경 구성, 새 라이브러리 학습 등입니다. 이 도움말에서는 Windows용 Visual Studio 2005 또는 Linux용 Mono와 기타 Unix 운영체제를 사용하여 .NET 클라이언트 라이브러리를 시작하는 방법에 대한 단계별 안내를 준비했습니다. 이를 통해 시작하는 데 시간을 절약하고 몇 가지 코드로 빠르게 작업할 수 있기를 바랍니다.

Visual Studio 2008

Visual Studio 2008이 아직 설치되어 있지 않은 경우 .NET 클라이언트 라이브러리로 작업할 수 있는 Visual Studio의 무료 버전인 Visual C# 2008 Express Edition을 사용하는 것이 좋습니다.

환경 설정

  1. http://code.google.com/p/google-gdata/downloads/list에서 클라이언트 라이브러리의 최신 MSI 버전을 다운로드합니다.
  2. 다운로드한 MSI 파일을 실행하여 패키지를 설치합니다. 기본적으로 'C:\Program Files\Google\Google Data API SDK\'에 설치됩니다. 이 문서의 추가 예시에서는 이 위치에 클라이언트 라이브러리를 설치했다고 가정합니다.
  3. 시작 메뉴의 'Google Data API SDK' 폴더에서 'Google Data API SDK'라는 솔루션 파일을 엽니다.

샘플 컴파일 및 실행

  1. 'Build > Build Solution' 실행이 오류 없이 완료되었는지 확인합니다.
  2. 디버그 빌드를 만들려면 'Build > Configuration Manager'로 이동하여 'Debug'를 활성 솔루션 구성으로 선택하세요. 그런 다음 'Build > Build Solution'을 선택합니다.
  3. 방금 컴파일한 바이너리 및 DLL 파일은 'C:\Program Files\Google\Google Data API SDK\Sources\Samples\"에서 확인할 수 있습니다. 예를 들어 'C:\Program Files\Google\Google Data API SDK\Sources\Samples\calendar\Debug\Calendar.exe'를 실행하여 Calendar용 샘플 애플리케이션을 실행할 수 있습니다. 샘플의 몇 가지 시작 메뉴 단축키도 있습니다.

자체 애플리케이션 개발

MSI 파일에서 제공하는 솔루션 파일 외의 프로젝트에서 개발하려면 클라이언트 라이브러리 DLL 파일을 참조 경로로 추가해야 합니다.

  1. Google API SDK 솔루션 외부에서 프로젝트를 만들거나 엽니다.
  2. 프로젝트 메뉴에서 '참조 추가'를 선택하세요.
  3. 찾아보기 탭을 클릭합니다.
  4. SDK의 Redis 디렉터리 'C:\Program Files\Google\Google Data API SDK\Redist'로 이동합니다.
  5. 코드에서 사용할 DLL 파일을 선택하세요. 대부분의 프로젝트에는 Google.GData.Extensions.dll과 Google.GData.Client.dll이 필요하며 애플리케이션에서 사용 중인 Google 서비스와 관련된 DLL 파일도 필요합니다.

참고: 휴대기기의 클라이언트 라이브러리를 위한 솔루션 파일도 있습니다. 기본적으로 'C:\Program Files\Google\Google Data API SDK\Sources\Library\VS2005.mobile'에 있습니다. 이 솔루션은 클라이언트 라이브러리의 DLL 파일만 컴파일합니다.

NUnit 테스트 실행

클라이언트 라이브러리를 변경하거나 테스트에 참여할 계획이라면 적절한 NUnit 테스트를 통과하는 것이 중요합니다. 클라이언트 라이브러리를 수정하지 않고 사용하려는 경우 일반적으로 이를 실행할 필요가 없습니다.

  1. http://www .nunit.org/index.php?p=download에서 NUnit의.NET 2.0 MSI 파일 출시 버전을 다운로드합니다.
  2. MSI 파일을 실행하여 NUnit을 설치합니다. 기본 설치 위치는 'C:\Program Files\NUnit 2.4.8'과 비슷합니다. Visual Studio 프로젝트에서 경로를 변경하지 않고도 나중에 NUnit을 업그레이드할 수 있도록 이를 'C:\Program Files\NUnit'과 같이 변경하는 것이 좋습니다.
  3. 'C:\Program Files\Google\Google Data API SDK\Sources\Library\VS2005' 디렉터리로 이동하여 'Google Data API'라는 이름의 솔루션 파일을 엽니다. Visual Studio 2005 프로젝트 파일이므로 전환 마법사가 표시됩니다. 표시되는 메시지를 모두 클릭하거나 '완료' 버튼을 클릭하면 됩니다. 이때 전환 로그는 표시되어 있어야 하며, 무시해도 됩니다.
  4. 이제 NUnit을 참조 경로로 추가해야 합니다. 솔루션 탐색기에서 'unittests' 프로젝트를 마우스 오른쪽 버튼으로 클릭하고 '속성'을 선택합니다. 창이 열리면 '참조 경로' 탭을 클릭합니다. NUnit 설치의 하위 디렉터리 'bin' 위치를 참조 경로로 입력하고 'Add Folder'를 클릭합니다. 예를 들어 NUnit이 'C:\Program Files\NUnit\'에 설치된 경우 'C:\Program Files\NUnit\bin'을 입력합니다. 계속하기 전에 이 변경사항을 저장해야 합니다.
  5. 샘플 컴파일 및 실행에 나열된 단계에 따라 클라이언트 라이브러리와 단위 테스트를 다시 빌드합니다.
  6. 'C:\Program Files\Google\Google Data API SDK\Sources\Library\unittests\"에 있는 'unittests.dll.config' 파일을 디버그 빌드 디렉터리 'C:\Program Files\Google\Google Data API SDK\Source\Library\VS2005\unittests\bin\Debug\"에 복사합니다. 실행 중인 테스트에 적합한 정보가 포함되도록 파일을 수정해야 합니다. 예를 들어 Base에는 API 키가 필요하고 Calendar에는 사용자 이름과 비밀번호가 필요합니다. 단위 테스트에서 정보를 삭제하지 않으려면 라이브 데이터 없이 테스트 계정을 사용하는 것이 좋습니다.
  7. 시작 메뉴에서 NUnit을 엽니다.
  8. 'File > Open Project'로 이동하여 'C:\Program Files\Google\Google Data API SDK\Source\Library\VS2005\unittests\bin\Debug\"에서 'unittests.dll' 파일을 선택합니다.
  9. 관심 있는 단위 테스트를 실행합니다. 일부 테스트에서는 unittests.dll.config에 매개변수가 설정되어 있어야 작동합니다. 특정 서비스에서 스트레스 테스트를 실행하면 테스트 계정이 스팸을 생성하는 것으로 신고되어 보안문자 문제가 발생하지 않은 이상 콘텐츠를 Google 서버에 프로그래매틱 방식으로 제출하지 못할 수 있습니다.

모노

Mono는 Linux, Solaris, Mac OS X, Windows, Unix에서 .NET 클라이언트 및 서버 애플리케이션을 실행할 수 있는 오픈소스 프로젝트입니다. 이러한 플랫폼 중 하나에서 작업하려는 개발자를 위해 클라이언트 라이브러리용 ZIP 파일을 별도로 제공합니다.

환경 설정

  1. http://code.google.com/p/google-gdata/downloads/list에서 클라이언트 라이브러리의 최신 ZIP 파일 버전을 다운로드합니다.
  2. 로컬 디렉터리 추출 (예: '/scratch/gdata.NET')
  3. 배포판의 패키지 관리를 사용하여 Mono를 설치합니다. http://www.mono-project.com에서 다운로드할 수도 있습니다.
  4. 일부 배포판에서는 nunit.framework.dll 파일이 모노 라이브러리에 제대로 연결되어 있는지 확인해야 합니다. 모노가 '/usr/lib/mono'에 설치된 경우 '/usr/lib/mono/1.0' 및 '/usr/lib/mono/2.0'의 심볼릭 링크가 nunit.framework.dll('/usr/lib/mono/gac/nunit.framework/<someversionstring.'에 설치되어야 함)에 있는지 확인합니다.

샘플 컴파일 및 실행

  1. '/scratch/gdata.NET'에 클라이언트 라이브러리를 설치했다고 가정하고 '/scratch/gdata.NET/clients/cs' 디렉터리로 변경합니다.
  2. 사용하려는 .NET 버전에 따라 Makefile을 수정합니다. .NET 1.x의 경우 CSC=mcs를 사용하고 .NET 2.x의 경우 CSC=gmcs를 사용합니다.
  3. make를 실행하여 라이브러리와 샘플 애플리케이션을 컴파일합니다.
  4. 클라이언트 라이브러리 DLL을 모노 라이브러리에 설치하려면 make install를 실행합니다.

자체 애플리케이션 개발

클라이언트 라이브러리를 컴파일한 후 make install를 실행했다면 -r:Google.GData.Extensions.dll -r:Google.GData.Client.dll을 Mono C# 컴파일러에 전달하고자 하는 특정 서비스 확장 프로그램의 DLL 파일 참조와 함께 자체 코드에 라이브러리를 포함할 수 있습니다.

NUnit 테스트 실행

  1. unittests.dll.config 파일을 '/scratch/gdata.NET/clients/cs/src/unittests'에서 '/scratch/gdata.NET/clients/cs/'로 복사합니다.
  2. 실행 중인 테스트에 적합한 정보가 포함되도록 '/scratch/gdata.NET/clients/cs/unittests.dll.config'를 수정합니다. 예를 들어 Base에는 API 키가 필요하고 Calendar에는 사용자 이름과 비밀번호가 필요합니다. 단위 테스트에서 정보가 삭제되지 않도록 하려면 라이브 데이터 없이 테스트 계정을 사용하는 것이 좋습니다.
  3. 라이브러리를 컴파일하면 '/scratch/gdata.NET/clients/cs'에 unittests.dll 파일이 생성됩니다. 원하는 NUnit 테스트 관리자 (nunit-console, gnunit 등)와 함께 이 DLL을 사용합니다.

마무리

이제 라이브러리를 컴파일하고 샘플 코드를 실행할 수 있습니다. 하지만 아직 시작에 불과합니다. 클라이언트 라이브러리의 ".../clients/cs/docs" 디렉터리에 있는 문서를 읽어 보시기 바랍니다. .NET 클라이언트 라이브러리 개발자 가이드, 프로젝트 페이지 및 참조 가이드, Google 데이터 .NET 클라이언트 라이브러리 포럼도 확인해 보세요.

이 도움말에서 언급한 도구는 다음과 같습니다.

다음번 .NET 애플리케이션에서 좋은 결과가 있길 바랍니다.