{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"style":{"value":"none"}},"macroMetadata":{"macroId":{"value":"58235699-a9f9-4976-bde6-625a56908caa"},"schemaVersion":{"value":"1"},"title":"목차"}},"localId":"ee96d86a-9480-409c-9edf-9ab0a7cda50b"}},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"1. 설치 환경 및 실행 환경","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"최소 버전","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Unreal 4.24.3 이상 지원","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"2. SDK 파일 구성","type":"text"}]},{"type":"paragraph","content":[{"text":"전달받은 KakaoGameSDK_Unreal_[버전].zip 파일은 다음과 같은 파일들로 구성되어 있습니다.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"274498d7-532f-4249-8d79-f8147a351d93"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"#f0f0f0","rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"파일","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#f0f0f0","rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"설명","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"KakaoGameSDKV4","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"배포되는 KakaoGameSDK 입니다.","type":"text"}]}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"APIReference","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"카카오게임 Unreal SDK의 API 레퍼런스 문서입니다.","type":"text"}]}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"Sample.zip","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"샘플 프로젝트","type":"text"}]}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"Utils","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"빌드에 필요한 스크립트가 포함 되어 있습니다.","type":"text"}]}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"Utils/IOSIPAScript.sh","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Unreal iOS 빌드 후 SwiftSupport 관련 처리를 위한 스크립트 입니다.","type":"text"}]}]}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"3. SDK 환경 설정","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"3.1. Unreal Plugin 추가하기","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Android, iOS, Windows용 카카오게임 SDK는 모두 Unreal Plugin 내에 포함되어 있습니다. 별도로 해당 SDK를 설치할 필요는 없습니다.","type":"text"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Unreal 프로젝트 폴더에서 Plugins 폴더를 찾습니다. (Plugins 폴더가 없는 경우 폴더를 생성합니다.)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"생성한 Plugins 폴더에 KakaoGameSDKV4 폴더를 추가합니다.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":398,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":398,"alt":"image-20240319-014243.png","id":"fcfa4cb6-3b3b-4ffe-a4b0-64eea45bc8f2","collection":"contentId-810975388","type":"file","height":257}}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Unreal Engine의 플러그인 메뉴에서 새로 추가한 KakaoGameSDK를 활성화 합니다.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":868,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1310,"alt":"image-20240808-010521.png","id":"23d11dd8-9b17-4c15-a473-79286f1ebbf9","collection":"contentId-810975388","type":"file","height":824}}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Unreal SDK를 프로젝트에서 사용하기 위해 프로젝트의 Build.cs 파일에서 다음과 같이 ","type":"text"},{"text":"KakaoGameSDKV4","type":"text","marks":[{"type":"strong"}]},{"text":"와 ","type":"text"},{"text":"Json","type":"text","marks":[{"type":"strong"}]},{"text":" 모듈을 추가합니다.","type":"text"},{"type":"hardBreak"},{"text":"KakaoGameSample.Build.cs","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"csharp"},"content":[{"text":"using UnrealBuildTool;\n \npublic class KakaoGameSample : ModuleRules\n{\n public KakaoGameSample(ReadOnlyTargetRules Target) : base(Target)\n {\n PCHUsage = PCHUsageMode.UseExplicitOrSharedPCHs;\n \n PublicDependencyModuleNames.AddRange(new string[] {\n \"KakaoGameSDKV4\",\n \"Json\",\n });\n \n PrivateDependencyModuleNames.AddRange(new string[] { });\n }\n}","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"3.2. Unreal Engine 설정하기","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"(중요)","type":"text","marks":[{"type":"strong"}]},{"text":" iOS 빌드를 하기 위해서는 아래 링크의 플랫폼 설정이 되어 있어야 합니다.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://kakaogames.atlassian.net/wiki/spaces/KS4GFC/pages/edit-v2/810975388#6.-iOS-%ED%94%8C%EB%9E%AB%ED%8F%BC-%EC%84%A4%EC%A0%95"}}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"(중요) ","type":"text","marks":[{"type":"strong"}]},{"text":"Android 빌드를 하기 위해서는 아래 링크의 플랫폼 설정이 되어 있어야 합니다.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://kakaogames.atlassian.net/wiki/spaces/KS4GFC/pages/edit-v2/810975388#5.-Android-%ED%94%8C%EB%9E%AB%ED%8F%BC-%EC%84%A4%EC%A0%95"}}]}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"4. 카카오게임 SDK 설정 하기","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Unreal Editor에서 세팅 -> 프로젝트 세팅 메뉴를 선택합니다.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":396,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":242,"alt":"image-20240808-010616.png","id":"46a0259d-d9ef-4329-97fe-980690fae72b","collection":"contentId-810975388","type":"file","height":154}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"좌측 메뉴의 플러그인 -> KakaoGameSDK 4.0 항목에서 카카오게임 SDK 설정이 가능한 메뉴가 있습니다.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":932,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1302,"alt":"image-20240808-011414.png","id":"05dc26cb-6172-45a4-99bf-b4963eb9c317","collection":"contentId-810975388","type":"file","height":818}}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"4.1. 카카오게임 속성 설정","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"카카오게임 속성 설정을 해야 합니다. 아래는 설정 항목에 대한 설명 입니다.","type":"text"}]}]}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"bde176d7-bc70-4e04-89c3-67744b6c3949"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"#f0f0f0","rowspan":1,"colwidth":[95.0]},"content":[{"type":"paragraph","content":[{"text":"키","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#f0f0f0","rowspan":1,"colwidth":[64.0]},"content":[{"type":"paragraph","content":[{"text":"타입","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#f0f0f0","rowspan":1,"colwidth":[48.0]},"content":[{"type":"paragraph","content":[{"text":"필수","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#f0f0f0","rowspan":1,"colwidth":[561.0]},"content":[{"type":"paragraph","content":[{"text":"설명","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#f0f0f0","rowspan":1,"colwidth":[192.0]},"content":[{"type":"paragraph","content":[{"text":"예시","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[95.0]},"content":[{"type":"paragraph","content":[{"text":"App Id","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[64.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[48.0]},"content":[{"type":"paragraph","content":[{"text":"O","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[561.0]},"content":[{"type":"paragraph","content":[{"text":"아래 둘 중 한곳에서 확인할 수 있습니다.","type":"text"},{"type":"hardBreak"},{"text":"카카오 개발자 페이지 > 내 어플리케이션 > 앱 선택 > 앱 설정 > 요약 정보","type":"text"},{"type":"hardBreak"},{"text":"카카오게임 어드민 -> 게임빌드 -> 클라이언트 버전 관리","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[192.0]},"content":[{"type":"paragraph","content":[{"text":"1113970","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[95.0]},"content":[{"type":"paragraph","content":[{"text":"App Secret","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[64.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[48.0]},"content":[{"type":"paragraph","content":[{"text":"O","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[561.0]},"content":[{"type":"paragraph","content":[{"text":"카카오 개발자 페이지 > 내 어플리케이션 > 앱 선택 > 앱 설정 > 요약 정보에서 확인할 수 있는 네이티브 앱 키와 동일합니다.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[192.0]},"content":[{"type":"paragraph","content":[{"text":"5b23360a86e87ba790b39475a98579bd","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[95.0]},"content":[{"type":"paragraph","content":[{"text":"App Version","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[64.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[48.0]},"content":[{"type":"paragraph","content":[{"text":"O","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[561.0]},"content":[{"type":"paragraph","content":[{"text":"앱 버전을 설정합니다. 이 버전을 기반으로 앱의 업데이트 필요 여부를 자동으로 안내합니다.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[192.0]},"content":[{"type":"paragraph","content":[{"text":"1.0.0","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[95.0]},"content":[{"type":"paragraph","content":[{"text":"Server Type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[64.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[48.0]},"content":[{"type":"paragraph","content":[{"text":"O","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[561.0]},"content":[{"type":"paragraph","content":[{"text":"SDK 와 연결될 플랫폼의 서버 타입을 설정합니다. 개발/테스트용 빌드에서는 \"QA\", 실제 서비스 용 빌드에서는 \"Live\" 로 설정하시면 됩니다.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[192.0]},"content":[{"type":"paragraph","content":[{"text":"Live (Default: Live)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[95.0]},"content":[{"type":"paragraph","content":[{"text":"Use Global","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[64.0]},"content":[{"type":"paragraph","content":[{"text":"Bool","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[48.0]},"content":[{"type":"paragraph","content":[{"text":"X","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[561.0]},"content":[{"type":"paragraph","content":[{"text":"글로벌 빌드인 경우 설정합니다.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"서버 타입 설정에 따라서 SDK에서 LiveGlobal로 서버 타입을 사용하게 됩니다.","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[192.0]},"content":[{"type":"paragraph","content":[{"text":"false (Default: false)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[95.0]},"content":[{"type":"paragraph","content":[{"text":"Log Level","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[64.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[48.0]},"content":[{"type":"paragraph","content":[{"text":"O","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[561.0]},"content":[{"type":"paragraph","content":[{"text":"SDK 로그 출력 레벨을 설정합니다. “None”, \"Verbose\", \"Debug\", \"Error\" 중 하나를 선택할 수 있습니다.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[192.0]},"content":[{"type":"paragraph","content":[{"text":"None","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[95.0]},"content":[{"type":"paragraph","content":[{"text":"Market (Android)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[64.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[48.0]},"content":[{"type":"paragraph","content":[{"text":"O","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[561.0]},"content":[{"type":"paragraph","content":[{"text":"안드로이드에서 배포할 마켓을 설정합니다.","type":"text"},{"type":"hardBreak"},{"text":"카카오게임 어드민 -> 게임빌드 -> 클라이언트 버전 관리에서 마켓 정보를 입력 해두어야 합니다. (iOS 마켓은 \"appStore\" 고정 입니다.)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[192.0]},"content":[{"type":"paragraph","content":[{"text":"googlePlay (Default: googlePlay)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[95.0]},"content":[{"type":"paragraph","content":[{"text":"Market (Windows)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[64.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[48.0]},"content":[{"type":"paragraph","content":[{"text":"O","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[561.0]},"content":[{"type":"paragraph","content":[{"text":"윈도우즈에서 배포할 마켓을 설정합니다.","type":"text"},{"type":"hardBreak"},{"text":"카카오게임 어드민 -> 게임빌드 -> 클라이언트 버전 관리에서 마켓 정보를 입력 해두어야 합니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"미설정시 기본값은 gameWeb 입니다.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[192.0]},"content":[{"type":"paragraph","content":[{"text":"gameWeb (Default: gameWeb)","type":"text"}]}]}]}]},{"type":"orderedList","attrs":{"order":2},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"아래와 같이 카카오게임 속성을 설정하도록 합니다.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":950,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":950,"alt":"image-20240808-011342.png","id":"5cf7b106-09f4-47a4-98fc-3f473efa5424","collection":"contentId-810975388","type":"file","height":262}}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"4.2. IDP 인증 정보 설정","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"4.2.1. 카카오 정보 설정","type":"text"}]},{"type":"paragraph","content":[{"text":"게임에서 카카오 인증을 사용할 경우, 설정 하도록 합니다.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":965,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":965,"alt":"image-20240808-011251.png","id":"a03557ae-b70f-46e8-b2fd-09701626e7d8","collection":"contentId-810975388","type":"file","height":102}}]},{"type":"paragraph","content":[{"text":"Windows 환경 및 Unreal Editor 환경에서 카카오 로그인을 사용하는 경우 JavaScript Key를 추가로 설정해야 합니다.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"c552d05d-0408-46af-8fa4-b7c907dd7246"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"#f0f0f0","rowspan":1,"colwidth":[95.0]},"content":[{"type":"paragraph","content":[{"text":"키","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#f0f0f0","rowspan":1,"colwidth":[64.0]},"content":[{"type":"paragraph","content":[{"text":"타입","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#f0f0f0","rowspan":1,"colwidth":[48.0]},"content":[{"type":"paragraph","content":[{"text":"필수","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#f0f0f0","rowspan":1,"colwidth":[561.0]},"content":[{"type":"paragraph","content":[{"text":"설명","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#f0f0f0","rowspan":1,"colwidth":[192.0]},"content":[{"type":"paragraph","content":[{"text":"예시","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[95.0]},"content":[{"type":"paragraph","content":[{"text":"JavaScript Key (Windows)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[64.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[48.0]},"content":[{"type":"paragraph","content":[{"text":"X","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[561.0]},"content":[{"type":"paragraph","content":[{"text":"카카오 파트너센터 > 앱정보에서 확인할 수 있는 JavaScript 키와 동일합니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"(Windows 환경에서 카카오 로그인을 사용하는 경우 필수로 설정해야 합니다.)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[192.0]},"content":[{"type":"paragraph","content":[{"text":"b8fbf489943235c3ca873cd8804ca9c6","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"모바일 환경에서 카카오 멀티앱 로그인을 사용하는 게임에서 각각 프로젝트의 Setting UI 상에서 Kakao MultiApp Login 체크 박스를 클릭 후에 빌드합니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"(멀티앱 로그인을 사용하려는 경우 별도 문의가 필요합니다.)","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":942,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":942,"alt":"image-20240808-011723.png","id":"4e14e647-287e-4e63-b28d-530f871699fe","collection":"contentId-810975388","type":"file","height":99}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"4.2.2. Sign in with Apple 정보 설정","type":"text"}]},{"type":"paragraph","content":[{"text":"게임에서 Sign in with Apple을 사용할 경우, 설정 하도록 합니다.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"아래 링크에 따라서 언리얼 엔진 설정을 추가합니다. (iOS Only)","type":"text"},{"type":"hardBreak"},{"text":"SigninWithApple 환경 설정","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SigninWithApple 체크 박스를 클릭합니다.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":906,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":906,"id":"bf342784-ed5c-4b45-b55c-ae6246b9915b","collection":"contentId-810975388","type":"file","height":83}}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"애플 어드민에서 발급받은 ClientId 항목을 입력합니다.","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":991,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1472,"id":"9d702f05-1f6a-470e-8ea0-74a7923080c2","collection":"contentId-810975388","type":"file","height":78}}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"5. Android 플랫폼 설정","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"5.1. 기본 설정","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"플러그인에 포함된 ","type":"text"},{"text":"KakaoGameSDKV4_Android_UPL.xml ","type":"text","marks":[{"type":"strong"}]},{"text":"파일을 통해 SDK에 필요한 기본 설정을 추가하고 있습니다.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SDK 에서는 아래 퍼미션들을 추가해서 사용하고 있습니다.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"android.permission.INTERNET","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"android.permission.ACCESSNETWORK_STATE","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ADID 를 얻기 위한 구글 설정","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"구글 Ads 최신 버전에서 해당 설정이 없는 경우 앱이 동작하지 않는 이슈가 있어 아래와 같이 기본 설정되어 있습니다.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"만약 게임에서 AdMob을 사용하고 있는 경우, ","type":"text"},{"text":"KakaoGameSDKV4_Android_UPL.xml","type":"text","marks":[{"type":"strong"}]},{"text":" 파일에서 해당 필드에 게임의 AdMob App Id를 삽입합니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"KakaoGameSDKV4_Android_UPL.xml","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"...\n\n\n\n...","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"5.1.1. APK Packaging 설정","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"프로젝트 셋팅 -> 플랫폼 -> Android 메뉴를 선택합니다.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"아래와 같이 APK Packaging 메뉴에서 Minimun SDK Version과 Target SDK Version을 설정합니다.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Minimum SDK Version : 23","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Target SDK Version : 34","type":"text","marks":[{"type":"strong"}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":630,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":630,"alt":"image-20240711-025305.png","id":"5b034ada-dbc1-4023-a3a9-4e3ac8e1c686","collection":"contentId-810975388","type":"file","height":247}}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"5.1.2. Manifest 설정","type":"text"}]},{"type":"paragraph","content":[{"text":"Unreal Engine의 설정 메뉴와 플러그인의 ","type":"text"},{"text":"KakaoGameSDKV4_Android_UPL.xml ","type":"text","marks":[{"type":"strong"}]},{"text":"파일을 통해서 Android Manifest에 값을 추가하거나 수정할 수 있습니다.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"API 23 이상에서는 앱이 일반 텍스트 HTTP와 같은 일반 텍스트 네트워크 트래픽을 사용하는지 여부를 설정할 수 있습니다.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"android:usesCleartextTraffic=\"true\"","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":758,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1280,"id":"a9b1d44a-f897-4588-9bfb-43d4f3dce47a","collection":"contentId-810975388","type":"file","height":599}}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"5.1.3. Http 사용 설정","type":"text"}]},{"type":"paragraph","content":[{"text":"targetSdkVersion을 28 버전 이상으로 설정하고 http 통신을 사용하는 게임은 아래와 같은 설정이 필요합니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"카카오 게임 SDK 내부에서는 http를 사용하지 않습니다. 개발사에서 cdn등 이슈로 http 콜이 필요한 경우에만 설정합니다.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"http 콜이 필요한 도메인 설정","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"KakaoGameSDKV4/Source/KakaoGameSDKV4/ThirdParty/Android/res/xml/network_security_config.xml 파일에 domain 추가","type":"text"}]},{"type":"paragraph","content":[{"text":"network_security_config.xml","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":" \n\n \n \n example.com\n \n","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"KakaoGameSDKV4_Android_UPL.xml ","type":"text","marks":[{"type":"strong"}]},{"text":"파일에서 networkSecurityConfig 설정","type":"text"}]},{"type":"paragraph","content":[{"text":"KakaoGameSDKV4_Android_UPL.xml","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"...\n\n \n....","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"5.1.4. 키 해시 확인 및 등록 방법","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"앱의 빌드를 위해서는 빌드 머신의 키 해시를 등록해야 하며 다음과 같은 방법으로 키 해시를 확인하실 수 있습니다.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"디버그 키 해시 및 릴리즈 키 해시를 위 가이드대로 구해서 [게임센터 > 게임관리 > 키 해시등록] 메뉴에 등록해주세요.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"5.2. Unreal Engine 설정","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"5.2.1. Unreal Engine aar-imports 설정 변경","type":"text"}]},{"type":"paragraph","content":[{"text":"Unreal Engine의 아래 파일에서 엔진에서 필요한 종속성을 추가하고 있습니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"(","type":"text"},{"text":"UE_X.XX/Engine/Build/Android/Java/aar-imports.txt)","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"KakaoGame Android SDK에서 포함하고 있는 다른 항목과 충돌하여 에러가 발생할 수 있어 다음과 같이 com.google.android.gms 항목들을 제거합니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"aar-imports.txt","type":"text","marks":[{"type":"strong"}]}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"5fb9fdeb-9765-4103-8564-f16415c54a0f"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1,"colwidth":[760.0]},"content":[{"type":"codeBlock","content":[{"text":"[기존]\nrepositories $(ANDROID_HOME)/extras\nrepositories $(ENGINEDIR)/Source/ThirdParty/Android/extras\ncom.google.android.gms,play-services-auth,11.8.0\ncom.google.android.gms,play-services-games,11.8.0\ncom.google.android.gms,play-services-nearby,11.8.0\ncom.google.android.gms,play-services-plus,11.8.0\n \n \n[변경]\nrepositories $(ANDROID_HOME)/extras\nrepositories $(ENGINEDIR)/Source/ThirdParty/Android/extras","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"5.2.2. Unreal Engine 빌드 Gradle 버전 변경","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"5.2.2.1. Gradle 설정","type":"text"}]},{"type":"paragraph","content":[{"text":"KakaoGame Android SDK의 경우 SDK 버전에 따라서 아래와 같이 Gradle 버전을 지원하고 있습니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"만약 호환되지 않은 버전인 경우 빌드 에러가 발생할 수 있습니다.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"834be2a8-7306-41b6-9339-0b6e3cd4772d"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1,"colwidth":[760.0]},"content":[{"type":"codeBlock","content":[{"text":"A problem occurred evaluating project ':app'.\n> Failed to apply plugin [id 'com.android.internal.version-check']\n> Minimum supported Gradle version is x.x.x. Current version is 4.6. If using the gradle wrapper, try editing the distributionUrl in ***","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Unreal Engine의 다음 경로의 gradle-wrapper.properties 파일에서 distributionUrl을 수정하여 gradle 버전을 변경할 수 있습니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"(UE_X.XX/Engine/Build/Android/Java/gradle/gradle/wrapper/gradle-wrapper.properties)","type":"text"}]},{"type":"paragraph","content":[{"text":"gradle-wrapper.properties","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Android 14 (Target SDK 34) 대응을 위해 ","type":"text"},{"text":"Gradle v7.2 이상","type":"text","marks":[{"type":"strong"}]},{"text":"으로 설정 되어 있어야 합니다.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":1490.0,"localId":"6b898dd9-33ab-47c1-ad48-7eeb5fd8ca51"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1,"colwidth":[730.0]},"content":[{"type":"codeBlock","content":[{"text":"distributionBase=GRADLE_USER_HOME\ndistributionPath=wrapper/dists\nzipStoreBase=GRADLE_USER_HOME\nzipStorePath=wrapper/dists\ndistributionUrl=https\\://services.gradle.org/distributions/gradle-7.2-all.zip","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Unreal Editor Android Gradle Plugin 버전 설정","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Android 14 (Target SDK 34) 대응을 위해 Android Gradle Plugin 버전 설정이 필요합니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"(개발 환경에 따라서 설정하는 버전이 다를 수 있습니다.)","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"KakaoGameSDK 4.0 > Android > Gradle Plugin 메뉴에서 아래와 같이 설정할 수 있습니다.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Use Custom Android Gradle Plugin","type":"text","marks":[{"type":"strong"}]},{"text":" 체크 활성화","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Custom Android Gradle Plugin Version","type":"text","marks":[{"type":"strong"}]},{"text":" 버전 7.1.2 설정","type":"text"}]}]}]}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1091,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1288,"alt":"image-20240808-012100.png","id":"6f803a04-f7e3-478e-8f41-724ff5c31504","collection":"contentId-810975388","type":"file","height":290}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"5.2.3. Unreal Engine Android 설정","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"5.2.3.1. Android 14 지원을 위한 JDK 설정","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Gradle v7.2, Android Gradle Plugin v7.1.2 버전으로 설정한 경우 JDK 버전 변경이 필요합니다.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"OpenJDK 11 버전을 다운로드 합니다. (","type":"text"},{"type":"inlineCard","attrs":{"url":"https://jdk.java.net/archive/"}},{"text":")","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Android SDK 빌드 설정에서 JDK 경로를 새로 다운로드한 JDK 11로 설정합니다.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":782,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":938,"alt":"image-20240624-021151.png","id":"c40c52c9-7343-4a50-b6bb-7b201012cb51","collection":"contentId-810975388","type":"file","height":234}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Android 빌드 설정 시 Target SDK 버전을 34로 설정합니다.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":630,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":630,"alt":"image-20240711-025305.png","id":"5b034ada-dbc1-4023-a3a9-4e3ac8e1c686","collection":"contentId-810975388","type":"file","height":247}}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"5.2.4. Unreal Engine Android 빌드 이슈 관련 설정","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"5.2.4.1. Android 14 이상 디바이스 지원을 위한 설정","type":"text"}]},{"type":"paragraph","content":[{"text":"Android targetSDK 34로 설정하고 Shipping이 아닌 개발 모드로 빌드하는 경우 Engine 환경에 따라서 Android 14 디바이스에서 아래와 같은 에러가 발생하는 경우가 있습니다.","type":"text"}]},{"type":"codeBlock","content":[{"text":"One of RECEIVER_EXPORTED or RECEIVER_NOT_EXPORTED should be specified when a receiver isn't being registered exclusively for system broadcasts ","type":"text"}]},{"type":"paragraph","content":[{"text":"UE_4.XX\\Engine\\Build\\Android\\Java\\src\\com\\epicgames\\ue4\\GameActivity.java.template","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"아래 GameActivity.java.template 부분의 registerReceiver 호출 부분 수정이 필요합니다.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"// 기존 코드\nregisterReceiver(consoleCmdReceiver, new IntentFilter(Intent.ACTION_RUN));\n\n\n// 추가 코드\nif (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {\n\tregisterReceiver(consoleCmdReceiver, new IntentFilter(Intent.ACTION_RUN), RECEIVER_EXPORTED);\n} else {\n\tregisterReceiver(consoleCmdReceiver, new IntentFilter(Intent.ACTION_RUN));\n}\n\n\n//GameActivity.java.template\n//$${gameActivityClassAdditions}$$\n\t@Override\n\tpublic void onStart()\n\t{\n\t\tsuper.onStart();\n\t\tif (!BuildConfiguration.equals(\"Shipping\"))\n\t\t{\n\t\t\t// Create console command broadcast listener\n\t\t\tLog.debug( \"Creating console command broadcast listener\");\n\t\t\tconsoleCmdReceiver = new ConsoleCmdReceiver(this);\n\t\t\t// Android 버전에 따라서 RECEIVER_EXPORTED를 추가로 설정하도록 분기처리 추가\n\t\t\tif (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {\n\t\t\t\tregisterReceiver(consoleCmdReceiver, new IntentFilter(Intent.ACTION_RUN), RECEIVER_EXPORTED);\n\t\t\t} else {\n\t\t\t\tregisterReceiver(consoleCmdReceiver, new IntentFilter(Intent.ACTION_RUN));\n\t\t\t}\n\t\t}\n//$${gameActivityOnStartAdditions}$$\n\t\tLog.debug(\"==================================> Inside onStart function in GameActivity\");\n\t}","type":"text"}]},{"type":"paragraph"},{"type":"paragraph"},{"type":"heading","attrs":{"level":4},"content":[{"text":"5.2.4.3. Android 12 이상 디바이스 지원을 위한 설정","type":"text"}]},{"type":"paragraph","content":[{"text":"Android 12 디바이스를 지원하기 위해 intent-filter를 사용하는 activity, service, broadcast receiver에서는 android:exported 속성을 명시적으로 선언해야 합니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"(","type":"text"},{"type":"inlineCard","attrs":{"url":"https://developer.android.com/about/versions/12/behavior-changes-12#exported"}},{"text":" )","type":"text"}]},{"type":"paragraph","content":[{"text":"Android 빌드 시 언리얼 엔진에서 기본으로 사용하는 GameActivity와 SplashActivity에 Android 12 대응을 위한 속성을 추가해야 합니다.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"다음 경로에서 UnrealBuildTool.csproj 파일을 찾아서 실행합니다. (Visual Stidio가 설치되어 있어야 합니다.)","type":"text"},{"type":"hardBreak"},{"text":"(UE_X.XX\\Engine\\Source\\Programs\\UnrealBuildTool\\UnrealBuildTool.csproj)","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":506,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":672,"id":"241f6032-64bc-4949-adb3-03ceb71c6c7a","collection":"contentId-810975388","type":"file","height":371}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"프로젝트의 UEDeployAndroid.cs 파일에서 아래와 같이 수정합니다.","type":"text"},{"type":"hardBreak"},{"text":"(UE_X.XX\\Engine\\Source\\Programs\\UnrealBuildTool\\Platform\\Android\\UEDeployAndroid.cs)","type":"text","marks":[{"type":"strong"}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":456,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":513,"id":"63b2c3f1-7312-437d-9fe2-d96ec03ee4bf","collection":"contentId-810975388","type":"file","height":279}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GenerateManifest ","type":"text","marks":[{"type":"strong"}]},{"text":"함수에서 SplashActivity, GameActivity 설정 부분에 다음 코드를 추가하고 Visual Studio에서 빌드를 수행합니다.","type":"text"}]},{"type":"codeBlock","content":[{"text":"Text.AppendLine(\"\\t\\t android:exported=\\\"true\\\"\");","type":"text"}]},{"type":"codeBlock","content":[{"text":"private string GenerateManifest(...)","type":"text"}]},{"type":"codeBlock","content":[{"text":"if (bShowLaunchImage)\n{\n\t// normal application settings\n\tText.AppendLine(\"\\t\\t\");\n\tText.AppendLine(\"\\t\\tCFBundleAllowMixedLocalizations","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"6.1.3. 사용자 추적 허용 팝업 노출 제어하기","type":"text"}]},{"type":"paragraph","content":[{"text":"iOS 14 이상 버전을 사용하는 사용자로 하여금 추적 허용 팝업을 노출할 수 있는 기능을 제공하고 있습니다.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":646,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1702,"id":"38c7fbd1-b498-40b6-9d55-cd53528ff4fb","collection":"contentId-810975388","type":"file","height":350}}]},{"type":"paragraph","content":[{"text":"추적 허용 팝업 기능을 사용하기 위해서는 아래 ","type":"text"},{"text":"NSUserTrackingUsageDescription ","type":"text","marks":[{"type":"strong"}]},{"text":"접근 권한 안내 문구 추가가 필요합니다.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":" 6.1.4. 접근 권한 설정","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Privacy - Description","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"iOS10부터 시스템앱에 접근을 할 때 안내문구를 반드시 입력해야합니다. 입력되지 않았을 경우는 스토어에 빌드 업로드 시 거부 될 수 있습니다.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"카카오게임 SDK에서 사용자 추적 허용 팝업을 노출하는 경우 NSUserTrackingUsageDescription 설정이 필요합니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"게임에서 사용하는 권한에 따라서 해당 부분의 접근 권한 설명을 아래와 같은 예시로 입력할 수 있습니다.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"77590175-bc61-47d6-847f-7f80828288da"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"#f0f0f0","rowspan":1,"colwidth":[260.0]},"content":[{"type":"paragraph","content":[{"text":"접근 권한","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#f0f0f0","rowspan":1,"colwidth":[500.0]},"content":[{"type":"paragraph","content":[{"text":"안내 문구 (예시)","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[260.0]},"content":[{"type":"paragraph","content":[{"text":"NSUserTrackingUsageDescription","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[500.0]},"content":[{"type":"paragraph","content":[{"text":"맞춤형 광고를 제공할 용도로 사용합니다.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[260.0]},"content":[{"type":"paragraph","content":[{"text":"NSCameraUsageDescription","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[500.0]},"content":[{"type":"paragraph","content":[{"text":"카메라 접근 권한 : 스크린 샷 촬영(고객센터 첨부) 기능을 위해서 카메라 사용을 허용해주세요.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[260.0]},"content":[{"type":"paragraph","content":[{"text":"NSMicrophoneUsageDescription","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[500.0]},"content":[{"type":"paragraph","content":[{"text":"비디오 접근 권한 : 비디오 촬영(고객센터 첨부) 기능을 위해서 마이크 사용을 허용해주세요.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[260.0]},"content":[{"type":"paragraph","content":[{"text":"NSPhotoLibraryUsageDescription","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[500.0]},"content":[{"type":"paragraph","content":[{"text":"사진첩 접근 권한 : 프로필 사진 설정과 스크린 샷 촬영(고객센터 첨부) 기능을 위한 사진첩 접근을 허용해주세요.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Unreal Engine의 Extra PList Data 메뉴에서 추가할 수 있습니다. ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":538,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":901,"id":"011b9f80-33bf-4c09-8c97-e42f7133eeb9","collection":"contentId-810975388","type":"file","height":80}}]},{"type":"paragraph","content":[{"text":"맞춤형 광고 동의 안내 설정","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"NSUserTrackingUsageDescription맞춤형 광고를 제공할 용도로 사용합니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"추가 접근 권한을 설정하는 경우","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"NSCameraUsageDescription카메라 접근 권한 : 스크린 샷 촬영(고객센터 첨부) 기능을 위해서 카메라 사용을 허용해주세요.NSMicrophoneUsageDescription비디오 접근 권한 : 비디오 촬영(고객센터 첨부) 기능을 위해서 마이크 사용을 허용해주세요.NSPhotoLibraryUsageDescription사진첩 접근 권한 : 프로필 사진 설정과 스크린 샷 촬영(고객센터 첨부) 기능을 위한 사진첩 접근을 허용해주세요.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"접근 권한 다국어 리소스 설정","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"다국어 설정을 위해서는 별도의 Localization 리소스가 빌드 폴더에 포함되어 있어야 합니다. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Extra PList Data에 값이 설정 되어 있어도 Localization 리소스가 추가 되어 있는 경우 Localization에 설정된 값이 노출 됩니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"(Extra PList Data, Localization 리소스 둘 다 설정되어 있지 않는 경우 앱이 정상적으로 동작하지 않을 수 있습니다.)","type":"text"}]}]},{"type":"paragraph","content":[{"text":"iOS 환경에서 아래 경로에 다국어 지원을 위한 리소스 추가가 필요합니다. (","type":"text","marks":[{"type":"strong"}]},{"text":"Unreal Engine 가이드 문서","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://dev.epicgames.com/documentation/ko-kr/unreal-engine/localizing-plist-and-nslocalizedstring-in-an-ios-project-in-unreal-engine"}}]},{"text":")","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"{UEProjectDir}/Build/IOS/Resources/Localizations/","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"아래는 영어, 일본어, 한국어, 중국어(번체) 설정 예시입니다.","type":"text"}]},{"type":"table","attrs":{"layout":"align-start","width":1800.0,"localId":"8b2576c2-b91b-4eb7-8b35-9cbe4cf620df"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"폴더 이름","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"설명","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"기타","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"en.lproj","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"영어 다국어 지원 리소스","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":4},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"각 폴더에 InfoPlist.strings 파일이 추가 되어 있어야 합니다.","type":"text"}]}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"ja.lproj","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"일본어 다국어 지원 리소스","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"ko.lproj","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"한국어 다국어 지원 리소스","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"zh-hant.lproj","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"중국어(번체) 다국어 지원 리소스","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":3,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"그 외 다른 언어 지원을 위해서는 Unreal Engine 가이드의 아래 내용에 따라서 추가가 필요합니다.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"현지화 폴더 이름은 ","type":"text"},{"text":"ISO 639-2","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.loc.gov/standards/iso639-2/php/code_list.php"}}]},{"text":" 표준 목록의 언어 코드를 사용하여 지정해야 합니다.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"예시) zh-hans.lproj / 중국어(간체) 다국어 지원 리소스 폴더","type":"text"}]}]}]}]}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":642,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":716,"alt":"image-20240627-062752.png","id":"d0d73014-7482-4a0d-8db9-9aea85c81453","collection":"contentId-810975388","type":"file","height":264}}]},{"type":"paragraph","content":[{"text":"InfoPlist.strings (en.lproj 영어 설정 파일 예시)","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"\"NSCameraUsageDescription\" = \"Camera access : Allow taking screenshots (for customer service attachments).\";\n\"NSMicrophoneUsageDescription\" = \"Video access : Allow microphone access for video recording (for customer service attachments).\";\n\"NSPhotoLibraryUsageDescription\" = \"Photo library access : For setting profile pictures and taking screenshots (for customer service attachments).\";\n\"NSUserTrackingUsageDescription\" = \"Used for providing personalized advertisements.\";","type":"text"}]},{"type":"paragraph","content":[{"text":"InfoPlist.strings (ja.lproj 일본어 설정 파일 예시)","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"\"NSCameraUsageDescription\" = \"カメラアクセス権限：スクリーンショット撮影(お問い合わせ添付用)機能の使用のため、カメラへのアクセスを許可をお願いします。\";\n\"NSMicrophoneUsageDescription\" = \"ビデオアクセス権限：ビデオ撮影(お問い合わせ添付用)機能の使用のため、ビデオへのアクセスを許可をお願いします。\";\n\"NSPhotoLibraryUsageDescription\" = \"アルバムアクセス権限：プロフィール写真設定とスクリーンショット撮影(お問い合わせ添付用)機能の使用のため、アルバムへのアクセスを許可をお願いします。\";\n\"NSUserTrackingUsageDescription\" = \"広告のカスタマイズのために使用します。\";","type":"text"}]},{"type":"paragraph","content":[{"text":"InfoPlist.strings (ko.lproj 한국어 설정 파일 예시)","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"\"NSCameraUsageDescription\" = \"카메라 접근 권한 : 스크린 샷 촬영(고객센터 첨부) 기능을 위해서 카메라 사용을 허용해주세요.\";\n\"NSMicrophoneUsageDescription\" = \"비디오 접근 권한 : 비디오 촬영(고객센터 첨부) 기능을 위해서 마이크 사용을 허용해주세요.\";\n\"NSPhotoLibraryUsageDescription\" = \"사진첩 접근 권한 : 프로필 사진 설정과 스크린 샷 촬영(고객센터 첨부) 기능을 위한 사진첩 접근을 허용해주세요.\";\n\"NSUserTrackingUsageDescription\" = \"맞춤형 광고를 제공할 용도로 사용합니다.\";","type":"text"}]},{"type":"paragraph","content":[{"text":"InfoPlist.strings (zh-hant.lproj 중국어(번체) 설정 파일 예시)","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"\"NSCameraUsageDescription\" = \"相機存取權限：為了截圖（提供客服中心）功能，請允許使用相機。\";\n\"NSMicrophoneUsageDescription\" = \"影片存取權限：為了錄影（提供客服中心）功能，請允許使用麥克風。\";\n\"NSPhotoLibraryUsageDescription\" = \"相簿存取權限：為了設定個人資料照片和截圖（客服中心附加）功能，請允許存取相簿。\";\n\"NSUserTrackingUsageDescription\" = \"用於提供個人化廣告。\";","type":"text"}]},{"type":"paragraph","content":[{"text":"다국어 리소스가 추가된 경우 .ipa 내부에 아래와 같이 리소스 폴더가 포함되어 있습니다.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":484,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":575,"alt":"image-20240626-073511.png","id":"ecd322c2-142b-40fa-8edd-cd0aaeb8d5b1","collection":"contentId-810975388","type":"file","height":465}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"6.1.5. 다중 Bundle ID 지원에 대한 안내","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"한 앱(app id)에 대하여 bundle ID를 여러 개 사용할 수 있습니다.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"테스트 빌드 등 복수의 번들 아이디가 필요한 경우를 지원 해드립니다.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"단, 게임센터에 등록된 bundle ID는 라이브 버전 (마켓에 올라가는 빌드 버전)과 일치해야 합니다.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"아래의 규칙에 해당하는 bundle ID는 카카오게임 API를 호출할 수 있습니다.","type":"text"},{"type":"hardBreak"},{"text":"단, 일부 기능에 대해 다소 제약이 있을 수 있습니다.","type":"text"}]}]}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"61b7d33a-fd43-4c23-b06a-a2698542ba1e"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[760.0]},"content":[{"type":"paragraph","content":[{"text":"게임센터에 등록된 bundle ID가 3단어 이상이고, 해당 bundle ID에 postfix가 붙을 경우","type":"text"}]},{"type":"paragraph","content":[{"text":"(예) 게임센터에 등록된(라이브 빌드의) bundle ID가 com.kakaogame.support 라면","type":"text"}]},{"type":"paragraph","content":[{"text":" com.kakaogame.support.alpha","type":"text"}]},{"type":"paragraph","content":[{"text":" com.kakaogame.support.beta","type":"text"}]},{"type":"paragraph","content":[{"text":" com.kakaogame.support.test","type":"text"}]},{"type":"paragraph","content":[{"text":"등의 bundle ID를 가진 앱 또한 카카오게임 API를 호출할 수 있습니다.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"6.2. Unreal Engine 설정","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"6.2.1. Swift 환경 설정","type":"text"}]},{"type":"paragraph","content":[{"text":"Unreal Swift Issue","type":"text","marks":[{"type":"strong"}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Unreal Engine에서는 Objective-c 와 Swift 를 혼합해서 사용하는 것을 지원하고 있지 않습니다. 혼합해서 사용하는 경우 빌드 에러가 발생합니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"iOS SDK에서는 Swift가 포함되어 있어서 관련 설정을 추가하는 작업이 필요합니다.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Unreal Engine에서 직접 수정하는 방법","type":"text","marks":[{"type":"strong"}]}]},{"type":"expand","attrs":{"title":"Unreal Engine에서 직접 수정하는 방법"},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Unreal Engine의 아래 경로에서 UnrealBuildTool.csproj 파일을 확인할 수 있습니다.","type":"text"},{"type":"hardBreak"},{"text":"(","type":"text"},{"text":"UE_X.XX/Engine/Source/Programs/UnrealBuildTool/UnrealBuildTool.csproj)","type":"text","marks":[{"type":"strong"}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":1010,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1050,"alt":"6-20231227-030754.png","id":"e8c05f2f-356b-4b65-95a4-e562c3fea525","collection":"contentId-810975388","type":"file","height":477}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"UnrealBuildTool.csproj 파일을 클릭하여 Visual Studio를 실행합니다. (Mac에서 Visual Studio Community를 사용할 수 있습니다.)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Unreal 5.x 버전","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"프로젝트에서 XcodeProjectLegacy.cs 파일을 선택합니다. ","type":"text"},{"type":"hardBreak"},{"text":"(UE_5.XX/Engine/Source/Programs/UnrealBuildTool/ProjectFiles/Xcode/XcodeProjectLegacy.cs)","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Unreal 4.x 버전","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"프로젝트에서 XcodeProject.cs 파일을 선택합니다. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"(UE_4.XX/Engine/Source/Programs/UnrealBuildTool/ProjectFiles/Xcode/XcodeProject.cs)","type":"text"}]}]}]}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"XcodeProject.cs 파일의 AppendProjectBuildConfiguration 함수에서 Swift 설정 관련 코드를 추가합니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"XcodeProject.cs","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"private void AppendProjectBuildConfiguration(StringBuilder Content, string ConfigName, string ConfigGuid)","type":"text"}]},{"type":"paragraph","content":[{"text":"XcodeProject.cs","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"// Swift Setting\nContent.Append(\"\\t\\t\\t\\tCLANG_ENABLE_MODULES = YES;\" + ProjectFileGenerator.NewLine);\nContent.Append(\"\\t\\t\\t\\tSWIFT_VERSION = 5.0;\" + ProjectFileGenerator.NewLine);\nContent.Append(\"\\t\\t\\t\\tLIBRARY_SEARCH_PATHS = \\\"$(TOOLCHAIN_DIR)/usr/lib/swift/$(PLATFORM_NAME)\\\";\" + ProjectFileGenerator.NewLine);\nif (ConfigName == \"Debug\")\n{\n Content.Append(\"\\t\\t\\t\\tSWIFT_OPTIMIZATION_LEVEL = \\\"-Onone\\\";\" + ProjectFileGenerator.NewLine);\n}\nContent.Append(\"\\t\\t\\t\\tALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES = YES;\" + ProjectFileGenerator.NewLine);\nContent.Append(\"\\t\\t\\t\\tEMBEDDED_CONTENT_CONTAINS_SWIFT = YES;\" + ProjectFileGenerator.NewLine);","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":1094,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1269,"id":"62d6ed19-12cf-4311-bb81-2dc00ab039b5","collection":"contentId-810975388","type":"file","height":682}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"프로젝트에서 IOSToolChain.cs 파일을 선택합니다. ","type":"text"},{"type":"hardBreak"},{"text":"(UE_4.XX/Engine/Source/Programs/UnrealBuildTool/Platform/IOS/IOSToolChain.cs)","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":1088,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1272,"id":"f41d4df6-3827-47a1-8cbc-04ee58ab0256","collection":"contentId-810975388","type":"file","height":712}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"IOSToolChain.cs 파일의 GetLinkArguments_Global 함수에서 Swift 설정 관련 코드를 추가합니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"IOSToolChain.cs","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"string GetLinkArguments_Global(LinkEnvironment LinkEnvironment)","type":"text"}]},{"type":"paragraph","content":[{"text":"IOSToolChain.cs","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Unreal 5.x 버전","type":"text"}]},{"type":"codeBlock","content":[{"text":"// Unreal 5.x 버전 Swift Setting\nArguments.Add(\"-rpath \\\"/usr/lib/swift\\\"\");\nArguments.Add(\"-rpath \\\"@executable_path/Frameworks\\\"\");\n// /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/usr/lib/swift/\nString swiftLibPath = String.Format(\" -L {0}Platforms/{1}.platform/Developer/SDKs/{1}{2}.sdk/usr/lib/swift\",\n\t\t\t\t\t\t\tSettings.Value.XcodeDeveloperDir, bIsDevice ? Settings.Value.DevicePlatformName : Settings.Value.SimulatorPlatformName, Settings.Value.IOSSDKVersion);\nArguments.Add(swiftLibPath);\n\n// /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/lib/swift/iphoneos\nswiftLibPath = String.Format(\" -L {0}Toolchains/XcodeDefault.xctoolchain/usr/lib/swift/{1}\",\n\t\t\t\t\t\t\tSettings.Value.XcodeDeveloperDir, bIsDevice ? Settings.Value.DevicePlatformName.ToLower() : Settings.Value.SimulatorPlatformName.ToLower());\nArguments.Add(swiftLibPath);\n\n// /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/lib/swift-5.0/iphoneos\nswiftLibPath = String.Format(\" -L {0}Toolchains/XcodeDefault.xctoolchain/usr/lib/swift-5.0/{1}\",\n\t\t\t\t\t\t\tSettings.Value.XcodeDeveloperDir, bIsDevice ? Settings.Value.DevicePlatformName.ToLower() : Settings.Value.SimulatorPlatformName.ToLower());\nArguments.Add(swiftLibPath);\nif (Settings.Value.IOSSDKVersionFloat >= 14.0f)\n{\n\tArguments.Add(String.Format(\" -lswiftCompatibility51\"));\n}","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Unreal 4.x 버전","type":"text"}]},{"type":"codeBlock","content":[{"text":"// Unreal 4.x 버전 Swift Setting\nResult += \" -rpath \\\"/usr/lib/swift\\\"\";\nResult += \" -rpath \\\"@executable_path/Frameworks\\\"\";\n// /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/usr/lib/swift/\nString swiftLibPath = String.Format(\" -L {0}Platforms/{1}.platform/Developer/SDKs/{1}{2}.sdk/usr/lib/swift\",\n Settings.Value.XcodeDeveloperDir, bIsDevice ? Settings.Value.DevicePlatformName : Settings.Value.SimulatorPlatformName, Settings.Value.IOSSDKVersion);\nResult += swiftLibPath;\n \n// /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/lib/swift/iphoneos\nswiftLibPath = String.Format(\" -L {0}Toolchains/XcodeDefault.xctoolchain/usr/lib/swift/{1}\",\n Settings.Value.XcodeDeveloperDir, bIsDevice ? Settings.Value.DevicePlatformName.ToLower() : Settings.Value.SimulatorPlatformName.ToLower());\nResult += swiftLibPath;\n \n// /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/lib/swift-5.0/iphoneos\nswiftLibPath = String.Format(\" -L {0}Toolchains/XcodeDefault.xctoolchain/usr/lib/swift-5.0/{1}\",\n Settings.Value.XcodeDeveloperDir, bIsDevice ? Settings.Value.DevicePlatformName.ToLower() : Settings.Value.SimulatorPlatformName.ToLower());\nResult += swiftLibPath;\nif (Settings.Value.IOSSDKVersionFloat >= 14.0f)\n{\n Result += String.Format(\" -lswiftCompatibility51\");\n}","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":958,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1268,"id":"ad93bb1a-4bc9-45d4-8cc7-cd9430eb6013","collection":"contentId-810975388","type":"file","height":682}}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"코드 추가 후 변경 사항을 적용하기 위해서 다음과 같이 빌드를 수행합니다.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":608,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":639,"id":"b864771e-93d3-4258-887a-1b439523ac6f","collection":"contentId-810975388","type":"file","height":246}}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"6.2.2. iOS 빌드 SwiftSupport 관련 앱스토어 리젝 이슈","type":"text"}]},{"type":"paragraph","content":[{"text":"Unreal에서 Swift 관련 라이브러리 설정 후 빌드를 하게 되면 ipa 파일 내에 SwiftSupport 폴더가 포함되어 있지 않습니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"앱스토어에서 다음과 같은 사유로 앱 등록이 거절될 수 있습니다. ","type":"text"},{"text":"(ITMS-90426: Invalid Swift Support - The SwiftSupport folder is missing.)","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Utils 폴더에 포함되어있는 ","type":"text"},{"text":"IOSIPAScript.sh","type":"text","marks":[{"type":"strong"}]},{"text":" 스크립트를 이용하여 ","type":"text"},{"text":"SwiftSupport ","type":"text","marks":[{"type":"strong"}]},{"text":"폴더가 추가된 ipa를 생성할 수 있습니다.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ipa_path는 ipa 파일의 절대 경로로 입력되어야 합니다.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"빌드 환경에 따라서 ","type":"text"},{"text":"IOSIPAScript.sh","type":"text","marks":[{"type":"strong"}]},{"text":" 스크립트 수정이 필요할 수 있습니다.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"스크립트는 다음과 같이 ipa_path로 unreal에서 ios 빌드 후 생성된 ipa 파일의 경로를 넘겨서 사용합니다.","type":"text"}]}]}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"7532bc53-5db0-4d0c-9e58-51af6b617ee9"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1,"colwidth":[760.0]},"content":[{"type":"codeBlock","content":[{"text":"bash IOSIPAScript.sh ipa_path=\"path/Distro_KakaoGameSample-IOS-Shipping.ipa\" project_name=\"KakaoGameSample\"","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"스크립트 동작이 완료 되면 -with-swift-support 가 붙은 ipa 파일이 생성 되고 내부에 SwiftSupport 폴더가 포함 된 것을 확인할 수 있습니다.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":572,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1117,"id":"9df10414-0172-4eb5-9c77-ba3c9beff866","collection":"contentId-810975388","type":"file","height":654}}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"6.2.2.1. IOSIPAScript","type":"text"}]},{"type":"paragraph","content":[{"text":"Utils 폴더에 포함되어 있는 IOSIPAScript.sh 스크립트 입니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"빌드를 수행하는 환경에 따라서 toolchain_path 수정이 필요할 수 있습니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"(기본 Xcode 경로로 설정되어 있습니다.)","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"toolchain_path가 ","type":"text"},{"text":"/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/lib/swift-5.0/iphoneos ","type":"text","marks":[{"type":"strong"}]},{"text":"기본 경로로 설정되어 있습니다.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"toolchain_path5_5가 ","type":"text"},{"text":"/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/lib/swift-5.5/iphoneos ","type":"text","marks":[{"type":"strong"}]},{"text":"기본 경로로 설정되어 있습니다.","type":"text"}]}]}]},{"type":"expand","attrs":{"title":"IOSIPAScript.sh"},"content":[{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"#!/bin/bash\n\nfor ARGUMENT in \"$@\"\ndo\n\n KEY=$(echo $ARGUMENT | cut -f1 -d=)\n VALUE=$(echo $ARGUMENT | cut -f2 -d=)\n\n case \"$KEY\" in\n ipa_path) ipaPath=${VALUE} ;; # Format: \"Path/to/app.ipa\"\n archive_path) archivePath=${VALUE} ;; # Format: \"Path/to/app.xcarchive\"\n toolchain_path) toolchainPath=${VALUE} ;; # Format: \"/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/lib/swift-5.0/iphoneos\"\n toolchain_path5_5) toolchain_path5_5=${VALUE} ;; # Format: \"/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/lib/swift-5.5/iphoneos\"\n project_name) projectName=${VALUE} ;; # Format: \"app\"\n *)\n esac\n\ndone\n\n# Default ToolChainPath\nif [ -z \"$toolchainPath\" ]\nthen\n toolchainPath=/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/lib/swift-5.0/iphoneos\nfi\n\nif [ -z \"$toolchain_path5_5\" ]\nthen\n toolchain_path5_5=/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/lib/swift-5.5/iphoneos\nfi\n\n# Derived Variables\nipaDirectory=$(dirname \"$ipaPath\")\nipaName=$(basename \"$ipaPath\")\nzipName=${ipaName/.ipa/.zip}\n\nif [ -z \"$projectName\" ]\nthen\n appName=${ipaName/.ipa/}\nelse\n appName=$projectName\nfi\n\nzipSuffix=-unzipped\nunzippedDirectoryName=${appName}${zipSuffix}\nnewIpaSuffix=-with-swift-support\nnewIpaName=${appName}${newIpaSuffix}\nswiftSupportPath=SwiftSupport/iphoneos\nipaSwiftSupportDirectory=${ipaDirectory}/${unzippedDirectoryName}/${swiftSupportPath}\n\n# Changes the .ipa file extension to .zip and unzips it\nfunction unzipIPA {\n mv \"${ipaDirectory}/${ipaName}\" \"${ipaDirectory}/${zipName}\"\n unzip \"${ipaDirectory}/${zipName}\" -d \"${ipaDirectory}/${unzippedDirectoryName}\"\n}\n\n# Copies the SwiftSupport folder from the .xcarchive into the .ipa\nfunction copySwiftSupportFromArchiveIntoIPA {\n mkdir -p \"$ipaSwiftSupportDirectory\"\n cd \"${archivePath}/${swiftSupportPath}\"\n for file in *.dylib; do\n cp \"$file\" \"$ipaSwiftSupportDirectory\"\n done\n}\n\n# Creates the SwiftSupport folder from the Xcode toolchain and copies it into the .ipa\nfunction copySwiftSupportFromToolchainIntoIPA {\n mkdir -p \"$ipaSwiftSupportDirectory\"\n cd \"${ipaDirectory}/${unzippedDirectoryName}/Payload/${appName}.app/Frameworks\"\n for file in *.dylib; do\n cp \"${toolchainPath}/${file}\" \"$ipaSwiftSupportDirectory\"\n done\n\n for file in *.dylib; do\n cp \"${toolchain_path5_5}/${file}\" \"$ipaSwiftSupportDirectory\"\n done\n}\n\n# Adds the SwiftSupport folder from one of two sources depending on the presence of an .xcarchive\nfunction addSwiftSupportFolder {\n if [ -z \"$archivePath\" ]\n then\n copySwiftSupportFromToolchainIntoIPA\n else\n copySwiftSupportFromArchiveIntoIPA\n fi\n}\n\n# Zips the new folder back up and changes the extension to .ipa\nfunction createAppStoreIPA {\n cd \"${ipaDirectory}/${unzippedDirectoryName}\"\n zip -r \"${ipaDirectory}/${newIpaName}.zip\" ./*\n mv \"${ipaDirectory}/${newIpaName}.zip\" \"${ipaDirectory}/${newIpaName}.ipa\"\n}\n\n# Renames original .ipa and deletes the unzipped folder\nfunction cleanUp {\n mv \"${ipaDirectory}/${zipName}\" \"${ipaDirectory}/${ipaName}\"\n rm -r \"${ipaDirectory}/${unzippedDirectoryName}\"\n}\n\n# Execute Steps\nunzipIPA\naddSwiftSupportFolder\ncreateAppStoreIPA\ncleanUp\n","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"7. Windows 플랫폼 설정","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"7.1. 기본 설정","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"플러그인의 아래 경로에 KakaoGame Windows SDK의 Binary가 포함되어 있습니다.","type":"text"},{"type":"hardBreak"},{"text":"(KakaoGameSDKV4/Source/KakaoGameSDKV4/ThirdParty/Windows/Binary)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Unreal 환경에서 Windows SDK를 사용하기 위해서는 Binaries/Win64 폴더에 KakaoGame Windows SDK가 포함되어 있어야 합니다.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"플러그인의 KakaoGameSDKV4.Build.cs 파일에 아래와 같이 기본 설정이 되어 있습니다.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"csharp"},"content":[{"text":"...\n// KakaoGame Windows SDK Copy\nstring TargetDir = Path.Combine(ModuleDirectory, \"ThirdParty/Windows/Binary\");\nstring[] ExtraFiles = Directory.GetFiles(TargetDir, \"*.*\", SearchOption.AllDirectories);\nstring OutDirectory = \"$(BinaryOutputDir)\";\n \nforeach (var path in ExtraFiles)\n{\n string relativePath = path.Replace(TargetDir, \".\");\n string finalPath = Path.Combine(OutDirectory, relativePath);\n RuntimeDependencies.Add(finalPath, path);\n}\n...","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Unreal Editor에서 Windows 빌드를 수행하는 경우 KakaoGame Windows SDK가 프로젝트의 Binaries/Win64와 빌드 된 경로의 PROJECT_NAME/Binaries/Win64) 경로에 복사가 됩니다.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":618,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":719,"id":"fc7ec571-4eec-4c7d-8604-f31afd4bd4d3","collection":"contentId-810975388","type":"file","height":672}}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"7.2. Unreal Editor 모드","type":"text"}]},{"type":"paragraph","content":[{"text":"프로젝트에 플러그인을 추가하고 실행하는 경우 KakaoGame Windows SDK가 기본적으로 프로젝트의 Binaries/Win64에 포함되어 있지 않아 Editor 환경에서 KakaoGameSDK 기능을 사용할 수 없습니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"KakaoGame Windows SDK의 Binary를 프로젝트의 Binaries/Win64의 경로에 직접 추가해야 합니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"(Unreal Editor에서 Windows 빌드를 수행하는 경우 자동으로 추가됩니다.)","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"64-bit 환경인 경우 다음 경로의 파일들을 복사합니다. (KakaoGameSDKV4/Source/KakaoGameSDKV4/ThirdParty/Windows/Binary/x64)","type":"text"}]}]}]}],"version":1}

지원되지 않는 브라우저