게임 내에서 SDK를 성공적으로 초기화하려면 몇 가지 요구사항을 충족해야 합니다. 예를 들면 다음과 같습니다.
디지털 서명된 게임 실행 파일에서 실행
Google Play 게임즈에서 게임 실행 파일 실행
이러한 요구사항은 게임 편집기나 코드 IDE 내에서 게임을 적극적으로 빌드하는 개발자에게 부담이 될 수 있습니다. 출시를 위해 게임을 패키징하고 게시해야 하기 때문입니다.
더 나은 개발 워크플로를 제공하기 위해 SDK는 개발자 모드를 제공합니다. 사용 설정하면 개발자 모드를 통해 SDK가 게임 편집기 또는 코드 IDE 내에서 작동할 수 있습니다. 실행 파일을 디지털 서명하거나 Google Play 게임에서 실행하지 않아도 SDK를 초기화할 수 있습니다.
기본 요건
사전 체험판 파트너 (EAP) GUID를 획득합니다. 개발팀이 게임 실행 파일을 패키징하거나 디지털 서명하지 않고도 또는 Google Play 게임에서 실행하지 않고도 게임 엔진 편집기 내에서 SDK를 사용할 수 있도록 하는 비밀 키입니다.
1단계: 매니페스트에서 개발자 모드 사용 설정
애플리케이션의 manifest.xml 내에서 IsDeveloperMode을 true로 설정하여 애플리케이션의 개발자 모드를 사용 설정합니다.
개발자 모드가 사용 설정되면 SDK는 API 호출 시 PC용 Google Play 게임즈에 로그인된 계정을 사용합니다. 여러 계정이 로그인되어 있는 경우 활성 계정이 사용됩니다.
게임이 공개적으로 출시되지 않은 경우 (Play Console 내 프로덕션 출시 트랙에 게시된 적이 없는 경우) 게임의 내부 테스트 그룹에 가입한 Google 계정을 사용하는 것이 좋습니다. 내부 테스터는 출시 전에 게임에 액세스할 수 있으며 이는 일부 SDK API가 작동하는 데 필요합니다. 예를 들어 Play 결제로 구매를 완료하는 경우입니다. Play Console에서 앱의 내부 테스터를 관리할 수 있습니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-02(UTC)"],[],[],null,["# Use the PC SDK while developing\n\nIn order to successfully initialize the SDK inside of a game several\nrequirements must be satisfied. These include:\n\n- Running from a digitally signed game executable\n\n- Launching the game executable from Google Play Games\n\nThese can be burdensome for developers that are actively building their game\ninside of a game editor or code IDE as they require packaging \\& publishing the\ngame for release.\n\nTo provide a better development workflow the SDK offers a developer\nmode. When enabled, the developer mode allows the SDK to function inside\nof a game editor or code IDE. The SDK can be initialized without\nrequiring the executable to be digitally signed or launched from Google Play\nGames.\n\nPrerequisites\n-------------\n\n- Obtain an early-access partner (EAP) GUID. This a secret key that allows your development team to use the SDK from within your game engine editor without needing to package or digitally sign your game executable or launch it from Google Play Games.\n\n| **Note:** Work with your Google Partner to get an early-access partner GUID for your development team. If you don't have an early-access partner, complete the [express interest form](https://docs.google.com/forms/d/e/1FAIpQLScn35BX-X63ggG84S76okR37nwq6qRA1PNPk4fsBpDbD7J21Q/viewform?_ga=2.233777694.1640262997.1747860154-345235146.1745606832).\n\n**Step 1**: Enable developer mode in the manifest\n-------------------------------------------------\n\n| **Warning:** Make sure to remove the `\u003cIsDeveloperMode\u003e` tag before publishing your game.\n\nEnable developer mode for your application by setting `IsDeveloperMode` to\n`true` inside of the your application's `manifest.xml`. \n\n \u003c?xml version=\"1.0\" encoding=\"utf-8\"?\u003e\n \u003cManifest version=\"1\"\u003e\n \u003cApplication\u003e\n \u003cPackageName\u003e\u003cvar translate=\"no\"\u003ecom.example.package\u003c/var\u003e\u003c/PackageName\u003e\n \\\u003cIsDeveloperMode\\\u003etrue\\\u003c/IsDeveloperMode\\\u003e\n \u003c/Application\u003e\n \u003c/Manifest\u003e\n\n**Step 2**: Enable early access\n-------------------------------\n\n| **Warning:** The early access partner GUID is a secret. Don't share this value.\n\nEnable early access on the device where your are testing by setting the\n`EarlyAccessPartnerGuid` string value under the\n`HKLM\\Software\\Google\\Play Games Services\\EarlyAccessPartnerGuid` registry key.\n\nThis can be done either using the Windows Registry Editor, or from an admin cmd\nterminal with the command: \n\n C:\\\u003e reg add \"HKLM\\Software\\Google\\Play Games Services\" /v EarlyAccessPartnerGuid /t REG_SZ /d \u003cvar translate=\"no\"\u003eEAP GUID\u003c/var\u003e\n\n**Step 3**: Sign into Google Play Games for PC\n----------------------------------------------\n\nWhen developer mode is enabled, the SDK uses the account signed into\n[Google Play Games for PC](https://play.google.com/googleplaygames) when making API\ncalls. If multiple accounts are signed in, the active account will be used.\n\nIf your game not been publicly released (has never published to the production\nrelease track inside of the Play Console), we recommend using a Google Account\nthat has joined your game's internal testing group. Internal testers will have\naccess to your game before release which is required for some SDK APIs to\nfunction. For example, completing a purchase with Play Billing. You may manage\nyour app's internal testers inside of the\n[Play Console](https://play.google.com/console/about/internal-testing/).\n\nNext steps\n----------\n\nAdd Google Play PC features to your app:\n\n- Sell digital goods with [Play Billing](/games/playgames/native-pc/billing)\n- Measure your marketing with [Play Install Referrer](/games/playgames/native-pc/install_referrer)"]]