기술 자료

Unity 엔진

Unity 엔진

애플리케이션 패치

반복 속도를 높이기 위해 전체 빌드가 아닌 애플리케이션 패치를 수행합니다.
읽는 시간 2분최근 업데이트: 9일 전

Android 애플리케이션을 빌드하는 데는 상당한 시간이 소요될 수 있습니다. 개발 중에 더 빠르게 반복할 수 있도록 애플리케이션 패키지를 다시 빌드하는 대신 패치할 수 있습니다. 애플리케이션 패키지를 패치할 때 Unity 마지막 패치 이후에 변경한 파일만 처리하고 연결된 Android 기기로 전송합니다.

애플리케이션 패치

애플리케이션을 패치하려면 Unity 에디터 또는 자체 빌드 파이프라인을 구현하는 경우 스크립팅 API 사용하면 됩니다.
애플리케이션을 처음 패치할 때 Unity 기기에서 패치 애플리케이션 환경을 설정합니다. 즉 첫 번째 패치는 이후 패치보다 오래 걸립니다.

에디터에서(From the Editor)

Unity 에디터 애플리케이션을 패치하는 방법은 다음과 같습니다.
  1. 빌드 프로파일 창을 엽니다(메뉴: 파일 > 빌드 프로필).
  2. Platforms 패널의 플랫폼 목록에서 Android를 선택하거나 Android 플랫폼을 위한 빌드 프로파일을 생성합니다.
  3. 플랫폼 설정 섹션에서
    Development Build

    ?

    를 활성화합니다.
  4. Build to Device 설정에서 Patch를 선택하거나, Unity가 빌드를 완료한 후 패치를 실행하려면 Patch And Run을 선택합니다.

스크립팅 API 사용

자체 빌드 파이프라인을 구현하는 경우 스크립팅 API 사용하여 애플리케이션을 패치할 수 있습니다. 이렇게 하려면 BuildOptions.BuildScriptsOnly 및 BuildOptions.PatchPackage 옵션을 BuildPipeline.BuildPlayer 메서드에 전달합니다.
예제는 아래와 같습니다.
BuildPlayerOptions buildPlayerOptions = new BuildPlayerOptions();buildPlayerOptions.scenes = new[] { "Assets/Scene1.unity"};buildPlayerOptions.target = BuildTarget.Android;// Use Patch & Run for all builds for optimal turn-around times.// (In prior versions, an initial regular Build & Run was necessary.)buildPlayerOptions.options = BuildOptions.PatchPackage | BuildOptions.AutoRunPlayer | BuildOptions.Development;BuildPipeline.BuildPlayer(buildPlayerOptions);

애플리케이션 패치 작동 방식

애플리케이션을 패치할 때 Unity:
  • 컴파일된 Java 소스가 모두 포함된 최소 APK를 생성합니다.
  • 마지막 패치 이후 변경된 파일을 가져와
    /storage/emulated/0/Android/data/<PackageName>/pram-shadow-files/
    의 응용 프로그램 캐시 폴더 내 디렉토리에 저장합니다.
  • Il2cpp을 사용하여 컴파일된 스크립트를 포함한 네이티브 라이브러리 파일을 애플리케이션의 데이터 디렉토리에 저장합니다.
    /data/data/<PackageName>/pram-shadow-files/lib/
    .
애플리케이션이 시작되면 APK 내부에 마커 파일이 있는지 확인합니다. 마커가 존재하는 경우 애플리케이션은 파일 읽기를
pram-shadow-files
디렉토리로 리디렉션합니다.
빌드 및 실행은 패치 파일을 삭제하지 않습니다. 대신 APK 설치를 대체합니다. 이렇게 하면
pram-shadow-files
디렉토리에 대한 리디렉션이 비활성화됩니다. 즉 후속 패치 빌드는 변경되지 않은 파일을 재사용할 수 있습니다.

패치 파일 지우기

Android 스토리지 설정을 사용하여 애플리케이션의 캐시를 지울 수 있습니다. 캐시를 지우면 애플리케이션 패치 빌드 프로세스에서 설치된 패치 파일이 제거됩니다.
애플리케이션의 캐시를 지우는 단계는 Android 기기에 따라 다릅니다. 디바이스의 단계를 찾으려면 다음 단계를 따르십시오.
  1. 기기 제조업체의 도움을 받으십시오.
  2. 디바이스 제조사를 찾아 해당 지원 웹사이트 링크를 따릅니다.
  3. 애플리케이션의 캐시 지우기에 대한 단계는 지원 웹사이트를 검색하세요.