Building an application for Android can take a significant amount of time. For faster iterations during development, you can patch the application package instead of rebuilding it. When you patch an application package, Unity only processes files you made changes to since the last patch and sends them to the connected Android device.
平台 | Application patching |
---|---|
Android | 受支持 |
ChromeOS | Unsupported |
To patch an application, you can use the Unity Editor or, if you implement your own build pipeline, the scripting API.
The first time you patch an application, Unity sets up the patch application environment on the device. This means that the first patch takes longer than future patches.
To patch an application from the Unity Editor:
If you implement your own build pipeline, you can use the scripting API to patch your application. To do this, pass the BuildOptions.BuildScriptsOnly and BuildOptions.PatchPackage options to the BuildPipeline.BuildPlayer method.
例如:
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);
When you patch an application, Unity:
/storage/emulated/0/Android/data/<PackageName>/pram-shadow-files/
./data/data/<PackageName>/pram-shadow-files/lib/
.When the application starts, it checks for a marker file inside the APK. If the marker exists, the application redirects its file reads to the pram-shadow-files
directory.
A Build & Run doesn’t clear any of the patch files. Instead, it replaces the APK install. This disables the redirect to the pram-shadow-files
directory. This means that subsequent patch builds can re-use unchanged files.
You can use the Android storage settings to clear the application’s cache. Clearing the cache removes the patch files installed by the application patching build process.
The steps to clear an application’s cache are different depending on the Android device. To find the steps for your device:
Did you find this page useful? Please give it a rating:
Thanks for rating this page!
What kind of problem would you like to report?
Thanks for letting us know! This page has been marked for review based on your feedback.
If you have time, you can provide more information to help us fix the problem faster.
Provide more information
You've told us this page needs code samples. If you'd like to help us further, you could provide a code sample, or tell us about what kind of code sample you'd like to see:
You've told us there are code samples on this page which don't work. If you know how to fix it, or have something better we could use instead, please let us know:
You've told us there is information missing from this page. Please tell us more about what's missing:
You've told us there is incorrect information on this page. If you know what we should change to make it correct, please tell us:
You've told us this page has unclear or confusing information. Please tell us more about what you found unclear or confusing, or let us know how we could make it clearer:
You've told us there is a spelling or grammar error on this page. Please tell us what's wrong:
You've told us this page has a problem. Please tell us more about what's wrong:
Thank you for helping to make the Unity documentation better!
Your feedback has been submitted as a ticket for our documentation team to review.
We are not able to reply to every ticket submitted.