態(tài)圖標(biāo)雙端工程化方案：Android activity-alias與iOS setAlternateIconName實(shí)戰(zhàn))
1. 動(dòng)態(tài)圖標(biāo)這件事到底在解決什么問題做過手游運(yùn)營的人都有一個(gè)共識(shí)App圖標(biāo)是成本最低、觸達(dá)最廣的運(yùn)營位。它不需要用戶打開游戲不需要推送權(quán)限甚至不需要用戶在線——只要圖標(biāo)躺在手機(jī)桌面上每一次解鎖屏幕都是一次曝光。春節(jié)換紅底、周年慶換金色、聯(lián)動(dòng)活動(dòng)換角色立繪這套玩法在國內(nèi)頭部手游里早就跑通了。但問題在于Unity作為跨平臺(tái)引擎本身并沒有提供一套統(tǒng)一的動(dòng)態(tài)圖標(biāo)API。Android和iOS兩端的實(shí)現(xiàn)路徑完全不同Android靠activity-alias做組件切換iOS靠setAlternateIconName做系統(tǒng)級(jí)替換。更麻煩的是Unity的構(gòu)建流程會(huì)覆蓋原生工程配置你手動(dòng)改的東西下一次出包就沒了。所以真正要解決的不是怎么換圖標(biāo)這個(gè)單點(diǎn)問題而是怎么在Unity的構(gòu)建管線里把雙端的動(dòng)態(tài)圖標(biāo)能力做成可配置、可自動(dòng)化、不丟配置的工程化方案。這篇文章適合三類人看一是正在做手游運(yùn)營功能開發(fā)的同學(xué)二是需要給項(xiàng)目加動(dòng)態(tài)圖標(biāo)但不知道從哪下手的Unity客戶端三是想了解Androidactivity-alias和iOS alternate icon底層機(jī)制的移動(dòng)端開發(fā)者。我會(huì)把兩端的原理、Unity側(cè)的工程改造、構(gòu)建腳本、踩過的坑全部攤開講代碼和配置都可以直接抄。先說結(jié)論Android端用activity-alias方案切換時(shí)會(huì)有一次桌面圖標(biāo)的閃動(dòng)系統(tǒng)會(huì)短暫移除再添加組件但兼容性最好從Android 5.0到14都沒問題iOS端用setAlternateIconName切換時(shí)系統(tǒng)會(huì)彈一個(gè)您已更改圖標(biāo)的提示框這個(gè)提示無法繞過除非用私有API不建議。兩端都需要在Unity構(gòu)建后處理原生工程文件這部分我用Editor腳本自動(dòng)化掉了。2. 雙端方案選型為什么Android用activity-aliasiOS用setAlternateIconName2.1 Android端activity-alias是唯一靠譜的路Android換圖標(biāo)這件事網(wǎng)上能搜到好幾種說法我一個(gè)個(gè)說清楚為什么最后選了activity-alias。第一種是直接改AndroidManifest.xml里application的android:icon屬性然后重新安裝。這顯然不行用戶不可能為了換個(gè)圖標(biāo)重新下載APK。第二種是用PackageManager.setComponentEnabledSetting動(dòng)態(tài)啟用/禁用組件。這個(gè)API本身沒問題關(guān)鍵在于你要啟用/禁用什么組件。Android的桌面圖標(biāo)本質(zhì)上是一個(gè)activity組件帶LAUNCHERcategory的那個(gè)你沒法直接替換一個(gè)activity的圖標(biāo)但你可以通過activity-alias創(chuàng)建多個(gè)別名每個(gè)別名指向同一個(gè)主Activity但各自帶不同的android:icon。然后通過setComponentEnabledSetting控制哪個(gè)別名處于啟用狀態(tài)。具體來說主Activity保持android:enabledfalse且不帶LAUNCHER category然后為每個(gè)圖標(biāo)創(chuàng)建一個(gè)activity-alias只有當(dāng)前選中的那個(gè)alias是enabledtrue且?guī)AUNCHER category。切換圖標(biāo) 禁用舊alias 啟用新alias。activity android:namecom.unity3d.player.UnityPlayerActivity android:exportedtrue android:enabledfalse intent-filter action android:nameandroid.intent.action.MAIN / /intent-filter /activity activity-alias android:name.icon_default android:targetActivitycom.unity3d.player.UnityPlayerActivity android:enabledtrue android:exportedtrue android:iconmipmap/app_icon_default android:labelstring/app_name intent-filter action android:nameandroid.intent.action.MAIN / category android:nameandroid.intent.category.LAUNCHER / /intent-filter /activity-alias activity-alias android:name.icon_festival android:targetActivitycom.unity3d.player.UnityPlayerActivity android:enabledfalse android:exportedtrue android:iconmipmap/app_icon_festival android:labelstring/app_name intent-filter action android:nameandroid.intent.action.MAIN / category android:nameandroid.intent.category.LAUNCHER / /intent-filter /activity-alias這里有幾個(gè)必須注意的細(xì)節(jié)我踩過坑主Activity的intent-filter里不能有LAUNCHER category否則桌面上會(huì)出現(xiàn)兩個(gè)圖標(biāo)。只保留MAIN action即可。每個(gè)alias的android:name建議用相對(duì)路徑如.icon_default這樣會(huì)自動(dòng)拼上包名避免硬編碼包名出錯(cuò)。android:enabled的初始狀態(tài)默認(rèn)圖標(biāo)那個(gè)alias設(shè)為true其他全部false。這個(gè)狀態(tài)會(huì)被系統(tǒng)持久化用戶重啟手機(jī)也不會(huì)丟。切換時(shí)用PackageManager.setComponentEnabledSetting必須傳DONT_KILL_APP標(biāo)志否則切換的瞬間你的進(jìn)程會(huì)被殺掉用戶體驗(yàn)極差。// Android側(cè)切換代碼 public void switchIcon(String aliasName) { PackageManager pm getPackageManager(); String pkg getPackageName(); // 先禁用所有alias String[] allAliases {icon_default, icon_festival, icon_anniversary}; for (String alias : allAliases) { pm.setComponentEnabledSetting( new ComponentName(pkg, pkg . alias), PackageManager.COMPONENT_ENABLED_STATE_DISABLED, PackageManager.DONT_KILL_APP ); } // 啟用目標(biāo)alias pm.setComponentEnabledSetting( new ComponentName(pkg, pkg . aliasName), PackageManager.COMPONENT_ENABLED_STATE_ENABLED, PackageManager.DONT_KILL_APP ); }實(shí)測下來這個(gè)方案在小米、華為、OPPO、vivo、三星的主流機(jī)型上都能正常工作。唯一的問題是切換瞬間桌面圖標(biāo)會(huì)有一個(gè)短暫的消失再出現(xiàn)的過程這是系統(tǒng)launcher重新加載組件導(dǎo)致的無法避免。我的做法是在切換前給用戶一個(gè)loading提示切換完成后彈一個(gè)Toast讓用戶知道發(fā)生了什么。2.2 iOS端setAlternateIconName的能與不能iOS從10.3開始提供了setAlternateIconName:completionHandler:這個(gè)API允許App在運(yùn)行時(shí)切換圖標(biāo)。但蘋果對(duì)這個(gè)功能加了很多限制你必須提前知道第一所有備選圖標(biāo)必須在Info.plist里預(yù)先聲明。你不能在運(yùn)行時(shí)動(dòng)態(tài)生成圖標(biāo)只能從預(yù)先打包進(jìn)Bundle的圖標(biāo)里選。聲明方式是在Info.plist里加一個(gè)CFBundleIcons字典keyCFBundleIcons/key dict keyCFBundlePrimaryIcon/key dict keyCFBundleIconFiles/key array stringAppIcon60x60/string /array /dict keyCFBundleAlternateIcons/key dict keyfestival/key dict keyCFBundleIconFiles/key array stringAppIcon_Festival60x60/string /array keyUIPrerenderedIcon/key false/ /dict keyanniversary/key dict keyCFBundleIconFiles/key array stringAppIcon_Anniversary60x60/string /array keyUIPrerenderedIcon/key false/ /dict /dict /dict第二圖標(biāo)文件必須放在Bundle根目錄下不能放在Assets.xcassets里。這是最容易踩的坑。Xcode的Asset Catalog雖然方便但setAlternateIconName只認(rèn)Bundle根目錄下的png文件。你需要把備選圖標(biāo)以AppIcon_Festival60x60.png、AppIcon_Festival60x602x.png、AppIcon_Festival60x603x.png的命名方式直接拖進(jìn)Xcode工程選擇Create folder references而不是Create groups。第三切換時(shí)會(huì)彈系統(tǒng)提示框。這是iOS的硬性行為提示內(nèi)容大概是您已更改XXX的圖標(biāo)。這個(gè)提示無法通過公開API繞過。有些團(tuán)隊(duì)用UIApplication.shared.isStatusBarHidden之類的hack去遮蓋但在新版本iOS上已經(jīng)失效了不建議折騰。第四切換必須在主線程調(diào)用且completionHandler里要處理錯(cuò)誤。如果圖標(biāo)名不存在或者文件缺失會(huì)返回error。// iOS側(cè)切換代碼 - (void)switchIcon:(NSString *)iconName { if (![UIApplication sharedApplication].supportsAlternateIcons) { NSLog(當(dāng)前設(shè)備不支持切換圖標(biāo)); return; } NSString *targetName [iconName isEqualToString:default] ? nil : iconName; [[UIApplication sharedApplication] setAlternateIconName:targetName completionHandler:^(NSError * _Nullable error) { if (error) { NSLog(切換圖標(biāo)失敗: %, error.localizedDescription); } else { NSLog(切換圖標(biāo)成功); } }]; }注意傳nil表示恢復(fù)默認(rèn)圖標(biāo)。另外supportsAlternateIcons這個(gè)屬性在iOS 10.3才可用低版本要加可用性判斷。2.3 兩端方案對(duì)比對(duì)比項(xiàng)Android (activity-alias)iOS (setAlternateIconName)最低支持版本Android 5.0iOS 10.3圖標(biāo)來源打包進(jìn)APK的mipmap資源打包進(jìn)Bundle的png文件切換時(shí)系統(tǒng)提示無但桌面圖標(biāo)會(huì)閃動(dòng)有彈窗無法繞過是否需要重啟App否否圖標(biāo)數(shù)量限制理論上無限制建議不超過10個(gè)審核風(fēng)險(xiǎn)無需在審核時(shí)說明用途3. Unity工程側(cè)改造讓構(gòu)建管線自動(dòng)處理原生配置3.1 為什么不能手動(dòng)改原生工程Unity的構(gòu)建流程是這樣的每次Build它都會(huì)重新生成Android的AndroidManifest.xml和iOS的Info.plist或者至少覆蓋你手動(dòng)改的部分。你這次手動(dòng)加了activity-alias下次出包就沒了。所以必須把配置注入到Unity的構(gòu)建管線里。Unity提供了兩個(gè)關(guān)鍵接口IPreprocessBuildWithReport和IPostprocessBuildWithReport。前者在構(gòu)建前執(zhí)行后者在構(gòu)建后執(zhí)行。對(duì)于Android我們需要在構(gòu)建后修改AndroidManifest.xml因?yàn)閁nity生成的manifest在構(gòu)建后才最終確定對(duì)于iOS我們需要在構(gòu)建后修改Info.plist并拷貝圖標(biāo)文件。3.2 Android側(cè)PostprocessBuild注入activity-aliasAndroid的manifest處理有個(gè)坑Unity構(gòu)建出來的工程AndroidManifest.xml在Temp/StagingArea目錄下構(gòu)建完成后會(huì)被拷貝到最終的Gradle工程里。我們需要在OnPostprocessBuild里找到這個(gè)文件并修改。using UnityEditor; using UnityEditor.Callbacks; using System.IO; using System.Xml; using UnityEngine; public class AndroidIconPostprocessor { [PostProcessBuild(1000)] public static void OnPostprocessBuild(BuildTarget target, string pathToBuiltProject) { if (target ! BuildTarget.Android) return; string manifestPath Path.Combine(pathToBuiltProject, AndroidManifest.xml); // 如果是Gradle工程路徑不同 if (EditorUserBuildSettings.exportAsGoogleAndroidProject) { manifestPath Path.Combine(pathToBuiltProject, unityLibrary, src, main, AndroidManifest.xml); } if (!File.Exists(manifestPath)) { Debug.LogError(找不到AndroidManifest.xml: manifestPath); return; } XmlDocument doc new XmlDocument(); doc.Load(manifestPath); XmlNode applicationNode doc.SelectSingleNode(/manifest/application); if (applicationNode null) return; // 找到主Activity移除LAUNCHER category設(shè)置enabledfalse XmlNode mainActivity FindMainActivity(applicationNode); if (mainActivity null) return; SetMainActivityDisabled(mainActivity); // 注入activity-alias string packageName doc.DocumentElement.GetAttribute(package); string[] iconNames { default, festival, anniversary }; foreach (string iconName in iconNames) { XmlElement alias CreateActivityAlias(doc, packageName, iconName); applicationNode.AppendChild(alias); } doc.Save(manifestPath); Debug.Log(Android動(dòng)態(tài)圖標(biāo)配置注入完成); } private static XmlNode FindMainActivity(XmlNode applicationNode) { foreach (XmlNode child in applicationNode.ChildNodes) { if (child.Name ! activity) continue; XmlNode intentFilter child.SelectSingleNode(intent-filter); if (intentFilter null) continue; XmlNode launcher intentFilter.SelectSingleNode(category[android:nameandroid.intent.category.LAUNCHER]); if (launcher ! null) return child; } return null; } private static void SetMainActivityDisabled(XmlNode activity) { XmlElement elem (XmlElement)activity; elem.SetAttribute(enabled, http://schemas.android.com/apk/res/android, false); // 移除LAUNCHER category XmlNode intentFilter activity.SelectSingleNode(intent-filter); if (intentFilter ! null) { XmlNode launcher intentFilter.SelectSingleNode(category[android:nameandroid.intent.category.LAUNCHER]); if (launcher ! null) intentFilter.RemoveChild(launcher); } } private static XmlElement CreateActivityAlias(XmlDocument doc, string packageName, string iconName) { XmlElement alias doc.CreateElement(activity-alias); alias.SetAttribute(name, http://schemas.android.com/apk/res/android, .icon_ iconName); alias.SetAttribute(targetActivity, http://schemas.android.com/apk/res/android, com.unity3d.player.UnityPlayerActivity); alias.SetAttribute(enabled, http://schemas.android.com/apk/res/android, iconName default ? true : false); alias.SetAttribute(exported, http://schemas.android.com/apk/res/android, true); alias.SetAttribute(icon, http://schemas.android.com/apk/res/android, mipmap/app_icon_ iconName); alias.SetAttribute(label, http://schemas.android.com/apk/res/android, string/app_name); XmlElement intentFilter doc.CreateElement(intent-filter); XmlElement action doc.CreateElement(action); action.SetAttribute(name, http://schemas.android.com/apk/res/android, android.intent.action.MAIN); XmlElement category doc.CreateElement(category); category.SetAttribute(name, http://schemas.android.com/apk/res/android, android.intent.category.LAUNCHER); intentFilter.AppendChild(action); intentFilter.AppendChild(category); alias.AppendChild(intentFilter); return alias; } }這段代碼有幾個(gè)關(guān)鍵點(diǎn)PostProcessBuild的優(yōu)先級(jí)設(shè)為1000確保在其他后處理腳本之后執(zhí)行處理了Gradle工程和直接APK兩種構(gòu)建模式用XmlDocument操作而不是字符串替換避免格式錯(cuò)誤。3.3 iOS側(cè)PostprocessBuild修改Info.plist并拷貝圖標(biāo)iOS這邊更麻煩一點(diǎn)因?yàn)槌烁腎nfo.plist還要把圖標(biāo)文件拷貝到正確的位置。Unity構(gòu)建出來的Xcode工程Info.plist在Unity-iPhone/Info.plist圖標(biāo)需要拷貝到Unity-iPhone/根目錄下。using UnityEditor; using UnityEditor.Callbacks; using System.IO; using UnityEditor.iOS.Xcode; using UnityEngine; public class IOSIconPostprocessor { [PostProcessBuild(1000)] public static void OnPostprocessBuild(BuildTarget target, string pathToBuiltProject) { if (target ! BuildTarget.iOS) return; string plistPath Path.Combine(pathToBuiltProject, Info.plist); PlistDocument plist new PlistDocument(); plist.ReadFromFile(plistPath); PlistElementDict rootDict plist.root; PlistElementDict bundleIcons rootDict.CreateDict(CFBundleIcons); // 主圖標(biāo) PlistElementDict primaryIcon bundleIcons.CreateDict(CFBundlePrimaryIcon); PlistElementArray primaryFiles primaryIcon.CreateArray(CFBundleIconFiles); primaryFiles.AddString(AppIcon60x60); // 備選圖標(biāo) PlistElementDict alternateIcons bundleIcons.CreateDict(CFBundleAlternateIcons); string[] iconNames { festival, anniversary }; foreach (string iconName in iconNames) { PlistElementDict iconDict alternateIcons.CreateDict(iconName); PlistElementArray iconFiles iconDict.CreateArray(CFBundleIconFiles); iconFiles.AddString(AppIcon_ Capitalize(iconName) 60x60); iconDict.SetBoolean(UIPrerenderedIcon, false); } plist.WriteToFile(plistPath); // 拷貝圖標(biāo)文件到Bundle根目錄 string sourceDir Assets/Editor/DynamicIcons/iOS; string destDir pathToBuiltProject; foreach (string iconName in iconNames) { string baseName AppIcon_ Capitalize(iconName) 60x60; CopyIconFile(sourceDir, destDir, baseName .png); CopyIconFile(sourceDir, destDir, baseName 2x.png); CopyIconFile(sourceDir, destDir, baseName 3x.png); } Debug.Log(iOS動(dòng)態(tài)圖標(biāo)配置注入完成); } private static void CopyIconFile(string sourceDir, string destDir, string fileName) { string src Path.Combine(sourceDir, fileName); string dst Path.Combine(destDir, fileName); if (File.Exists(src)) { File.Copy(src, dst, true); } else { Debug.LogWarning(圖標(biāo)文件不存在: src); } } private static string Capitalize(string s) { if (string.IsNullOrEmpty(s)) return s; return char.ToUpper(s[0]) s.Substring(1); } }這里用了Unity的PlistDocument類來操作plist比直接改XML安全得多。圖標(biāo)文件我放在Assets/Editor/DynamicIcons/iOS/目錄下構(gòu)建時(shí)自動(dòng)拷貝。3.4 Unity與原生層的橋接Unity側(cè)要調(diào)用原生的切換方法需要做平臺(tái)判斷和橋接。Android用AndroidJavaObjectiOS用DllImport。using UnityEngine; public class DynamicIconManager : MonoBehaviour { public static void SwitchIcon(string iconName) { #if UNITY_ANDROID !UNITY_EDITOR using (AndroidJavaClass unityPlayer new AndroidJavaClass(com.unity3d.player.UnityPlayer)) using (AndroidJavaObject activity unityPlayer.GetStaticAndroidJavaObject(currentActivity)) { activity.Call(runOnUiThread, new AndroidJavaRunnable(() { activity.Call(switchIcon, icon_ iconName); })); } #elif UNITY_IOS !UNITY_EDITOR _SwitchIcon(iconName); #else Debug.Log(編輯器模式下不執(zhí)行圖標(biāo)切換: iconName); #endif } #if UNITY_IOS !UNITY_EDITOR [System.Runtime.InteropServices.DllImport(__Internal)] private static extern void _SwitchIcon(string iconName); #endif }iOS側(cè)需要一個(gè).mm文件來暴露C接口給Unity// DynamicIcon.mm #import UIKit/UIKit.h extern C { void _SwitchIcon(const char* iconName) { NSString *name [NSString stringWithUTF8String:iconName]; dispatch_async(dispatch_get_main_queue(), ^{ if (![UIApplication sharedApplication].supportsAlternateIcons) return; NSString *target [name isEqualToString:default] ? nil : name; [[UIApplication sharedApplication] setAlternateIconName:target completionHandler:^(NSError *error) { if (error) NSLog(切換圖標(biāo)失敗: %, error); }]; }); } }這個(gè).mm文件需要放在Assets/Plugins/iOS/目錄下Unity會(huì)自動(dòng)把它編譯進(jìn)Xcode工程。4. 實(shí)操全流程從資源準(zhǔn)備到出包驗(yàn)證4.1 圖標(biāo)資源規(guī)范與準(zhǔn)備Android和iOS對(duì)圖標(biāo)尺寸的要求不一樣我整理了一個(gè)對(duì)照表平臺(tái)用途尺寸命名規(guī)范存放位置Androidmipmap-mdpi48x48app_icon_default.pngAssets/Plugins/Android/res/mipmap-mdpi/Androidmipmap-hdpi72x72app_icon_default.pngAssets/Plugins/Android/res/mipmap-hdpi/Androidmipmap-xhdpi96x96app_icon_default.pngAssets/Plugins/Android/res/mipmap-xhdpi/Androidmipmap-xxhdpi144x144app_icon_default.pngAssets/Plugins/Android/res/mipmap-xxhdpi/Androidmipmap-xxxhdpi192x192app_icon_default.pngAssets/Plugins/Android/res/mipmap-xxxhdpi/iOS60x601x60x60AppIcon_Festival60x60.pngAssets/Editor/DynamicIcons/iOS/iOS60x602x120x120AppIcon_Festival60x602x.pngAssets/Editor/DynamicIcons/iOS/iOS60x603x180x180AppIcon_Festival60x603x.pngAssets/Editor/DynamicIcons/iOS/Android的圖標(biāo)放在Assets/Plugins/Android/res/下Unity構(gòu)建時(shí)會(huì)自動(dòng)合并到APK的res目錄。注意不要放在Assets/Resources/下那樣不會(huì)被打進(jìn)原生資源。iOS的圖標(biāo)命名有個(gè)坑CFBundleIconFiles里寫的是AppIcon_Festival60x60系統(tǒng)會(huì)自動(dòng)去找AppIcon_Festival60x60.png、AppIcon_Festival60x602x.png、AppIcon_Festival60x603x.png。所以命名必須嚴(yán)格一致大小寫敏感。4.2 構(gòu)建腳本的完整配置把上面兩個(gè)Postprocessor腳本放到Assets/Editor/目錄下Unity會(huì)自動(dòng)識(shí)別。但有幾個(gè)配置項(xiàng)需要確認(rèn)Player Settings → Publishing Settings → Build如果勾選了Custom Main ManifestUnity會(huì)用你提供的manifest而不是自動(dòng)生成。這種情況下你需要手動(dòng)在自定義manifest里加aliasPostprocessor腳本要相應(yīng)調(diào)整。Player Settings → Other Settings → Package Name確保包名正確alias的name會(huì)基于包名生成。iOS Player Settings → Icon這里配置的是主圖標(biāo)備選圖標(biāo)不走這里走我們的Postprocessor。我建議的做法是不勾選Custom Main Manifest讓Unity自動(dòng)生成然后Postprocessor在構(gòu)建后注入。這樣最省心。4.3 切換邏輯的時(shí)機(jī)與狀態(tài)管理圖標(biāo)切換不是隨便什么時(shí)候都能調(diào)的。我的經(jīng)驗(yàn)是不要在App啟動(dòng)時(shí)立即切換。啟動(dòng)階段系統(tǒng)資源緊張切換容易失敗。建議在進(jìn)入主界面后延遲1-2秒再執(zhí)行。切換狀態(tài)要持久化。用PlayerPrefs記錄當(dāng)前圖標(biāo)名下次啟動(dòng)時(shí)對(duì)比服務(wù)端下發(fā)的配置如果一致就不重復(fù)切換避免不必要的閃動(dòng)和彈窗。切換前檢查網(wǎng)絡(luò)和資源。如果圖標(biāo)資源是熱更下載的Android可以iOS不行因?yàn)閳D標(biāo)必須打包進(jìn)Bundle要確保下載完成再切換。public class IconSwitchController : MonoBehaviour { private const string ICON_KEY current_icon_name; void Start() { Invoke(CheckAndSwitchIcon, 2f); } private void CheckAndSwitchIcon() { string serverIcon GetServerIconConfig(); // 從服務(wù)端或本地配置讀取 string localIcon PlayerPrefs.GetString(ICON_KEY, default); if (serverIcon ! localIcon) { DynamicIconManager.SwitchIcon(serverIcon); PlayerPrefs.SetString(ICON_KEY, serverIcon); PlayerPrefs.Save(); } } }4.4 出包驗(yàn)證清單出包后別急著發(fā)按這個(gè)清單過一遍Android安裝后桌面圖標(biāo)是否正常顯示默認(rèn)圖標(biāo)用adb shell dumpsys package 包名查看alias的enabled狀態(tài)是否正確。Android調(diào)用切換后桌面圖標(biāo)是否變成目標(biāo)圖標(biāo)殺掉App重開圖標(biāo)是否保持Android切換時(shí)App是否被殺掉如果被殺檢查DONT_KILL_APP標(biāo)志是否傳了。iOS安裝后圖標(biāo)是否正常切換時(shí)是否彈出系統(tǒng)提示切換后圖標(biāo)是否變化iOS殺掉App重開圖標(biāo)是否保持恢復(fù)默認(rèn)圖標(biāo)是否正常雙端連續(xù)切換多次是否有異常圖標(biāo)資源是否都正確打包5. 常見問題與排查技巧實(shí)錄5.1 Android端典型問題問題一桌面上出現(xiàn)兩個(gè)圖標(biāo)。這是最常見的問題。原因通常是主Activity的intent-filter里還保留著LAUNCHER category。檢查AndroidManifest.xml確保主Activity的intent-filter里只有MAIN action沒有LAUNCHER category。另外檢查是否有多個(gè)alias同時(shí)處于enabled狀態(tài)。問題二切換后圖標(biāo)沒變但alias狀態(tài)變了。這種情況通常是launcher緩存導(dǎo)致的。不同廠商的launcher刷新機(jī)制不一樣小米和華為一般會(huì)立即刷新OPPO和vivo可能有延遲。解決辦法是切換后發(fā)一個(gè)廣播通知launcher刷新但這不是標(biāo)準(zhǔn)API各廠商支持情況不一。我的做法是切換后彈一個(gè)Toast提示用戶圖標(biāo)將在幾秒后更新給用戶預(yù)期。問題三切換時(shí)App閃退。檢查是否在主線程調(diào)用setComponentEnabledSetting。這個(gè)API必須在主線程執(zhí)行。另外檢查alias的name是否拼寫正確ComponentName的第二個(gè)參數(shù)必須是完整類名包名alias名。問題四某些機(jī)型上alias不生效。部分定制ROM尤其是早期的EMUI和MIUI對(duì)activity-alias的支持有問題。實(shí)測下來Android 7.0以上的主流機(jī)型基本沒問題Android 5.x和6.x的部分機(jī)型可能有兼容性問題。如果目標(biāo)用戶里老機(jī)型占比高建議做降級(jí)處理檢測切換是否成功失敗則提示用戶手動(dòng)更換。5.2 iOS端典型問題問題一切換時(shí)報(bào)錯(cuò)icon name not found。檢查三件事Info.plist里CFBundleAlternateIcons的key是否和傳入的name一致圖標(biāo)文件是否在Bundle根目錄下不是Assets.xcassets文件名是否和CFBundleIconFiles里聲明的一致包括2x、3x后綴。問題二切換時(shí)彈窗提示您已更改圖標(biāo)能否去掉不能。這是iOS的系統(tǒng)行為公開API無法繞過。有些團(tuán)隊(duì)嘗試用UIAlertController的私有方法去攔截但在iOS 13以后已經(jīng)失效。接受它或者在產(chǎn)品層面引導(dǎo)用戶比如切換前先彈一個(gè)自定義提示說明會(huì)有一個(gè)系統(tǒng)彈窗。問題三審核時(shí)被拒說動(dòng)態(tài)圖標(biāo)功能不明確。App Store審核指南對(duì)動(dòng)態(tài)圖標(biāo)沒有明確禁止但如果你的App切換圖標(biāo)后功能沒有變化審核員可能認(rèn)為這是無意義的功能。建議在審核時(shí)提供說明動(dòng)態(tài)圖標(biāo)用于節(jié)日活動(dòng)或用戶個(gè)性化并在App內(nèi)提供明確的切換入口。問題四iPad上不生效。iPad的圖標(biāo)尺寸和iPhone不一樣CFBundleIconFiles需要額外聲明iPad的尺寸如AppIcon_Festival76x76。如果只聲明了60x60iPad上可能不生效。建議同時(shí)聲明iPhone和iPad的圖標(biāo)尺寸。5.3 雙端通用問題速查表問題現(xiàn)象可能原因排查方向解決方案切換后圖標(biāo)不變資源未打包檢查APK/Bundle里是否有圖標(biāo)文件確認(rèn)資源路徑正確切換后App重啟未傳DONT_KILL_APP檢查Android代碼加上標(biāo)志iOS切換報(bào)錯(cuò)plist配置錯(cuò)誤檢查CFBundleAlternateIcons修正key和文件名桌面出現(xiàn)雙圖標(biāo)LAUNCHER category重復(fù)檢查manifest移除主Activity的LAUNCHER切換狀態(tài)丟失未持久化檢查PlayerPrefs切換后立即Save部分機(jī)型不生效ROM兼容性查看系統(tǒng)版本做降級(jí)提示5.4 我踩過的幾個(gè)坑第一個(gè)坑是Android的alias name用了絕對(duì)路徑。一開始我寫的是com.example.game.icon_default結(jié)果在某些機(jī)型上不生效。后來改成相對(duì)路徑.icon_default讓系統(tǒng)自動(dòng)拼包名問題解決。原因是絕對(duì)路徑在某些ROM上會(huì)被當(dāng)成不同的組件處理。第二個(gè)坑是iOS圖標(biāo)文件放進(jìn)了Assets.xcassets。Xcode的Asset Catalog會(huì)把圖標(biāo)編譯成Assets.carsetAlternateIconName根本找不到。必須用folder reference的方式直接放Bundle根目錄。第三個(gè)坑是Unity構(gòu)建時(shí)覆蓋了Info.plist。我一開始在Xcode里手動(dòng)改了plist結(jié)果Unity重新構(gòu)建后全沒了。后來用Postprocessor腳本自動(dòng)注入才徹底解決。第四個(gè)坑是切換時(shí)機(jī)太早。在Awake里調(diào)用切換Android上經(jīng)常失敗因?yàn)锳ctivity還沒完全初始化。改成延遲2秒后調(diào)用穩(wěn)定了。6. 工程化擴(kuò)展與進(jìn)階玩法6.1 圖標(biāo)配置表驅(qū)動(dòng)硬編碼圖標(biāo)名不是好做法。我建議用ScriptableObject做配置表把圖標(biāo)名、資源路徑、生效時(shí)間、平臺(tái)限制都配置化。[CreateAssetMenu(fileName IconConfig, menuName DynamicIcon/IconConfig)] public class IconConfig : ScriptableObject { [System.Serializable] public class IconEntry { public string iconName; public string displayName; public long startTime; public long endTime; public bool enableAndroid; public bool enableIOS; } public ListIconEntry icons new ListIconEntry(); public string GetActiveIcon(long currentTime) { foreach (var icon in icons) { if (currentTime icon.startTime currentTime icon.endTime) return icon.iconName; } return default; } }這樣運(yùn)營配置活動(dòng)時(shí)只需要改配置表不需要改代碼。6.2 服務(wù)端下發(fā)與灰度圖標(biāo)切換的配置最好走服務(wù)端下發(fā)這樣可以隨時(shí)調(diào)整活動(dòng)時(shí)間不需要發(fā)版。服務(wù)端返回一個(gè)JSON客戶端解析后對(duì)比本地狀態(tài)決定是否切換。灰度方面可以按用戶ID哈?；蛘咔腊鼇砜刂颇男┯脩魠⑴c。6.3 與熱更系統(tǒng)的配合Android的圖標(biāo)資源可以走熱更因?yàn)閍lias的icon屬性可以指向下載到本地的資源實(shí)際上不行alias的icon必須是打包進(jìn)APK的資源。所以Android的備選圖標(biāo)也必須預(yù)先打包進(jìn)APK不能熱更。這一點(diǎn)和iOS一樣。所以動(dòng)態(tài)圖標(biāo)的動(dòng)態(tài)指的是切換時(shí)機(jī)動(dòng)態(tài)而不是圖標(biāo)資源動(dòng)態(tài)。這個(gè)認(rèn)知很重要很多團(tuán)隊(duì)一開始以為可以熱更圖標(biāo)結(jié)果發(fā)現(xiàn)不行。如果確實(shí)需要大量圖標(biāo)比如用戶自定義圖標(biāo)Android可以通過PackageManager的setComponentEnabledSetting配合動(dòng)態(tài)生成的alias來實(shí)現(xiàn)但需要反射調(diào)用隱藏API風(fēng)險(xiǎn)較高不建議。6.4 用戶體驗(yàn)優(yōu)化建議切換圖標(biāo)這件事用戶感知很強(qiáng)但也很容易做成騷擾。我的建議是給用戶選擇權(quán)。不要強(qiáng)制切換在設(shè)置里提供圖標(biāo)選擇入口讓用戶自己選。切換前告知。尤其是iOS系統(tǒng)彈窗會(huì)讓用戶困惑提前用自定義彈窗說明。提供恢復(fù)默認(rèn)的入口。用戶換了圖標(biāo)后想換回來要能方便地找到。不要頻繁切換。一天切好幾次會(huì)讓用戶覺得App不穩(wěn)定。我在實(shí)際項(xiàng)目里的做法是默認(rèn)圖標(biāo)保持不變只在重大活動(dòng)時(shí)通過服務(wù)端配置切換活動(dòng)結(jié)束后自動(dòng)恢復(fù)。同時(shí)在設(shè)置里提供圖標(biāo)樣式選項(xiàng)讓喜歡個(gè)性化的用戶自己選。這樣既保證了運(yùn)營效果又不打擾普通用戶。最后分享一個(gè)小技巧Android端可以在切換后發(fā)一個(gè)自定義廣播Intent.ACTION_PACKAGE_CHANGED部分launcher會(huì)響應(yīng)這個(gè)廣播刷新圖標(biāo)能減少圖標(biāo)閃動(dòng)的時(shí)間。但這個(gè)廣播不是所有l(wèi)auncher都認(rèn)只能算錦上添花。iOS端則可以在切換完成后用UIApplication.shared.applicationIconBadgeNumber觸發(fā)一次刷新有時(shí)候能讓圖標(biāo)更快更新但效果不穩(wěn)定看系統(tǒng)版本。 Unity手游動(dòng)態(tài)圖標(biāo)雙端工程化方案：Android activity-alias與iOS setAlternateIconName實(shí)戰(zhàn)
1. 動(dòng)態(tài)圖標(biāo)這件事到底在解決什么問題做過手游運(yùn)營的人都有一個(gè)共識(shí)App圖標(biāo)是成本最低、觸達(dá)最廣的運(yùn)營位。它不需要用戶打開游戲不需要推送權(quán)限甚至不需要用戶在線——只要圖標(biāo)躺在手機(jī)桌面上每一次解鎖屏幕都是一次曝光。春節(jié)換紅底、周年慶換金色、聯(lián)動(dòng)活動(dòng)換角色立繪這套玩法在國內(nèi)頭部手游里早就跑通了。但問題在于Unity作為跨平臺(tái)引擎本身并沒有提供一套統(tǒng)一的動(dòng)態(tài)圖標(biāo)API。Android和iOS兩端的實(shí)現(xiàn)路徑完全不同Android靠activity-alias做組件切換iOS靠setAlternateIconName做系統(tǒng)級(jí)替換。更麻煩的是Unity的構(gòu)建流程會(huì)覆蓋原生工程配置你手動(dòng)改的東西下一次出包就沒了。所以真正要解決的不是怎么換圖標(biāo)這個(gè)單點(diǎn)問題而是怎么在Unity的構(gòu)建管線里把雙端的動(dòng)態(tài)圖標(biāo)能力做成可配置、可自動(dòng)化、不丟配置的工程化方案。這篇文章適合三類人看一是正在做手游運(yùn)營功能開發(fā)的同學(xué)二是需要給項(xiàng)目加動(dòng)態(tài)圖標(biāo)但不知道從哪下手的Unity客戶端三是想了解Androidactivity-alias和iOS alternate icon底層機(jī)制的移動(dòng)端開發(fā)者。我會(huì)把兩端的原理、Unity側(cè)的工程改造、構(gòu)建腳本、踩過的坑全部攤開講代碼和配置都可以直接抄。先說結(jié)論Android端用activity-alias方案切換時(shí)會(huì)有一次桌面圖標(biāo)的閃動(dòng)系統(tǒng)會(huì)短暫移除再添加組件但兼容性最好從Android 5.0到14都沒問題iOS端用setAlternateIconName切換時(shí)系統(tǒng)會(huì)彈一個(gè)您已更改圖標(biāo)的提示框這個(gè)提示無法繞過除非用私有API不建議。兩端都需要在Unity構(gòu)建后處理原生工程文件這部分我用Editor腳本自動(dòng)化掉了。2. 雙端方案選型為什么Android用activity-aliasiOS用setAlternateIconName2.1 Android端activity-alias是唯一靠譜的路Android換圖標(biāo)這件事網(wǎng)上能搜到好幾種說法我一個(gè)個(gè)說清楚為什么最后選了activity-alias。第一種是直接改AndroidManifest.xml里application的android:icon屬性然后重新安裝。這顯然不行用戶不可能為了換個(gè)圖標(biāo)重新下載APK。第二種是用PackageManager.setComponentEnabledSetting動(dòng)態(tài)啟用/禁用組件。這個(gè)API本身沒問題關(guān)鍵在于你要啟用/禁用什么組件。Android的桌面圖標(biāo)本質(zhì)上是一個(gè)activity組件帶LAUNCHERcategory的那個(gè)你沒法直接替換一個(gè)activity的圖標(biāo)但你可以通過activity-alias創(chuàng)建多個(gè)別名每個(gè)別名指向同一個(gè)主Activity但各自帶不同的android:icon。然后通過setComponentEnabledSetting控制哪個(gè)別名處于啟用狀態(tài)。具體來說主Activity保持android:enabledfalse且不帶LAUNCHER category然后為每個(gè)圖標(biāo)創(chuàng)建一個(gè)activity-alias只有當(dāng)前選中的那個(gè)alias是enabledtrue且?guī)AUNCHER category。切換圖標(biāo) 禁用舊alias 啟用新alias。activity android:namecom.unity3d.player.UnityPlayerActivity android:exportedtrue android:enabledfalse intent-filter action android:nameandroid.intent.action.MAIN / /intent-filter /activity activity-alias android:name.icon_default android:targetActivitycom.unity3d.player.UnityPlayerActivity android:enabledtrue android:exportedtrue android:iconmipmap/app_icon_default android:labelstring/app_name intent-filter action android:nameandroid.intent.action.MAIN / category android:nameandroid.intent.category.LAUNCHER / /intent-filter /activity-alias activity-alias android:name.icon_festival android:targetActivitycom.unity3d.player.UnityPlayerActivity android:enabledfalse android:exportedtrue android:iconmipmap/app_icon_festival android:labelstring/app_name intent-filter action android:nameandroid.intent.action.MAIN / category android:nameandroid.intent.category.LAUNCHER / /intent-filter /activity-alias這里有幾個(gè)必須注意的細(xì)節(jié)我踩過坑主Activity的intent-filter里不能有LAUNCHER category否則桌面上會(huì)出現(xiàn)兩個(gè)圖標(biāo)。只保留MAIN action即可。每個(gè)alias的android:name建議用相對(duì)路徑如.icon_default這樣會(huì)自動(dòng)拼上包名避免硬編碼包名出錯(cuò)。android:enabled的初始狀態(tài)默認(rèn)圖標(biāo)那個(gè)alias設(shè)為true其他全部false。這個(gè)狀態(tài)會(huì)被系統(tǒng)持久化用戶重啟手機(jī)也不會(huì)丟。切換時(shí)用PackageManager.setComponentEnabledSetting必須傳DONT_KILL_APP標(biāo)志否則切換的瞬間你的進(jìn)程會(huì)被殺掉用戶體驗(yàn)極差。// Android側(cè)切換代碼 public void switchIcon(String aliasName) { PackageManager pm getPackageManager(); String pkg getPackageName(); // 先禁用所有alias String[] allAliases {icon_default, icon_festival, icon_anniversary}; for (String alias : allAliases) { pm.setComponentEnabledSetting( new ComponentName(pkg, pkg . alias), PackageManager.COMPONENT_ENABLED_STATE_DISABLED, PackageManager.DONT_KILL_APP ); } // 啟用目標(biāo)alias pm.setComponentEnabledSetting( new ComponentName(pkg, pkg . aliasName), PackageManager.COMPONENT_ENABLED_STATE_ENABLED, PackageManager.DONT_KILL_APP ); }實(shí)測下來這個(gè)方案在小米、華為、OPPO、vivo、三星的主流機(jī)型上都能正常工作。唯一的問題是切換瞬間桌面圖標(biāo)會(huì)有一個(gè)短暫的消失再出現(xiàn)的過程這是系統(tǒng)launcher重新加載組件導(dǎo)致的無法避免。我的做法是在切換前給用戶一個(gè)loading提示切換完成后彈一個(gè)Toast讓用戶知道發(fā)生了什么。2.2 iOS端setAlternateIconName的能與不能iOS從10.3開始提供了setAlternateIconName:completionHandler:這個(gè)API允許App在運(yùn)行時(shí)切換圖標(biāo)。但蘋果對(duì)這個(gè)功能加了很多限制你必須提前知道第一所有備選圖標(biāo)必須在Info.plist里預(yù)先聲明。你不能在運(yùn)行時(shí)動(dòng)態(tài)生成圖標(biāo)只能從預(yù)先打包進(jìn)Bundle的圖標(biāo)里選。聲明方式是在Info.plist里加一個(gè)CFBundleIcons字典keyCFBundleIcons/key dict keyCFBundlePrimaryIcon/key dict keyCFBundleIconFiles/key array stringAppIcon60x60/string /array /dict keyCFBundleAlternateIcons/key dict keyfestival/key dict keyCFBundleIconFiles/key array stringAppIcon_Festival60x60/string /array keyUIPrerenderedIcon/key false/ /dict keyanniversary/key dict keyCFBundleIconFiles/key array stringAppIcon_Anniversary60x60/string /array keyUIPrerenderedIcon/key false/ /dict /dict /dict第二圖標(biāo)文件必須放在Bundle根目錄下不能放在Assets.xcassets里。這是最容易踩的坑。Xcode的Asset Catalog雖然方便但setAlternateIconName只認(rèn)Bundle根目錄下的png文件。你需要把備選圖標(biāo)以AppIcon_Festival60x60.png、AppIcon_Festival60x602x.png、AppIcon_Festival60x603x.png的命名方式直接拖進(jìn)Xcode工程選擇Create folder references而不是Create groups。第三切換時(shí)會(huì)彈系統(tǒng)提示框。這是iOS的硬性行為提示內(nèi)容大概是您已更改XXX的圖標(biāo)。這個(gè)提示無法通過公開API繞過。有些團(tuán)隊(duì)用UIApplication.shared.isStatusBarHidden之類的hack去遮蓋但在新版本iOS上已經(jīng)失效了不建議折騰。第四切換必須在主線程調(diào)用且completionHandler里要處理錯(cuò)誤。如果圖標(biāo)名不存在或者文件缺失會(huì)返回error。// iOS側(cè)切換代碼 - (void)switchIcon:(NSString *)iconName { if (![UIApplication sharedApplication].supportsAlternateIcons) { NSLog(當(dāng)前設(shè)備不支持切換圖標(biāo)); return; } NSString *targetName [iconName isEqualToString:default] ? nil : iconName; [[UIApplication sharedApplication] setAlternateIconName:targetName completionHandler:^(NSError * _Nullable error) { if (error) { NSLog(切換圖標(biāo)失敗: %, error.localizedDescription); } else { NSLog(切換圖標(biāo)成功); } }]; }注意傳nil表示恢復(fù)默認(rèn)圖標(biāo)。另外supportsAlternateIcons這個(gè)屬性在iOS 10.3才可用低版本要加可用性判斷。2.3 兩端方案對(duì)比對(duì)比項(xiàng)Android (activity-alias)iOS (setAlternateIconName)最低支持版本Android 5.0iOS 10.3圖標(biāo)來源打包進(jìn)APK的mipmap資源打包進(jìn)Bundle的png文件切換時(shí)系統(tǒng)提示無但桌面圖標(biāo)會(huì)閃動(dòng)有彈窗無法繞過是否需要重啟App否否圖標(biāo)數(shù)量限制理論上無限制建議不超過10個(gè)審核風(fēng)險(xiǎn)無需在審核時(shí)說明用途3. Unity工程側(cè)改造讓構(gòu)建管線自動(dòng)處理原生配置3.1 為什么不能手動(dòng)改原生工程Unity的構(gòu)建流程是這樣的每次Build它都會(huì)重新生成Android的AndroidManifest.xml和iOS的Info.plist或者至少覆蓋你手動(dòng)改的部分。你這次手動(dòng)加了activity-alias下次出包就沒了。所以必須把配置注入到Unity的構(gòu)建管線里。Unity提供了兩個(gè)關(guān)鍵接口IPreprocessBuildWithReport和IPostprocessBuildWithReport。前者在構(gòu)建前執(zhí)行后者在構(gòu)建后執(zhí)行。對(duì)于Android我們需要在構(gòu)建后修改AndroidManifest.xml因?yàn)閁nity生成的manifest在構(gòu)建后才最終確定對(duì)于iOS我們需要在構(gòu)建后修改Info.plist并拷貝圖標(biāo)文件。3.2 Android側(cè)PostprocessBuild注入activity-aliasAndroid的manifest處理有個(gè)坑Unity構(gòu)建出來的工程AndroidManifest.xml在Temp/StagingArea目錄下構(gòu)建完成后會(huì)被拷貝到最終的Gradle工程里。我們需要在OnPostprocessBuild里找到這個(gè)文件并修改。using UnityEditor; using UnityEditor.Callbacks; using System.IO; using System.Xml; using UnityEngine; public class AndroidIconPostprocessor { [PostProcessBuild(1000)] public static void OnPostprocessBuild(BuildTarget target, string pathToBuiltProject) { if (target ! BuildTarget.Android) return; string manifestPath Path.Combine(pathToBuiltProject, AndroidManifest.xml); // 如果是Gradle工程路徑不同 if (EditorUserBuildSettings.exportAsGoogleAndroidProject) { manifestPath Path.Combine(pathToBuiltProject, unityLibrary, src, main, AndroidManifest.xml); } if (!File.Exists(manifestPath)) { Debug.LogError(找不到AndroidManifest.xml: manifestPath); return; } XmlDocument doc new XmlDocument(); doc.Load(manifestPath); XmlNode applicationNode doc.SelectSingleNode(/manifest/application); if (applicationNode null) return; // 找到主Activity移除LAUNCHER category設(shè)置enabledfalse XmlNode mainActivity FindMainActivity(applicationNode); if (mainActivity null) return; SetMainActivityDisabled(mainActivity); // 注入activity-alias string packageName doc.DocumentElement.GetAttribute(package); string[] iconNames { default, festival, anniversary }; foreach (string iconName in iconNames) { XmlElement alias CreateActivityAlias(doc, packageName, iconName); applicationNode.AppendChild(alias); } doc.Save(manifestPath); Debug.Log(Android動(dòng)態(tài)圖標(biāo)配置注入完成); } private static XmlNode FindMainActivity(XmlNode applicationNode) { foreach (XmlNode child in applicationNode.ChildNodes) { if (child.Name ! activity) continue; XmlNode intentFilter child.SelectSingleNode(intent-filter); if (intentFilter null) continue; XmlNode launcher intentFilter.SelectSingleNode(category[android:nameandroid.intent.category.LAUNCHER]); if (launcher ! null) return child; } return null; } private static void SetMainActivityDisabled(XmlNode activity) { XmlElement elem (XmlElement)activity; elem.SetAttribute(enabled, http://schemas.android.com/apk/res/android, false); // 移除LAUNCHER category XmlNode intentFilter activity.SelectSingleNode(intent-filter); if (intentFilter ! null) { XmlNode launcher intentFilter.SelectSingleNode(category[android:nameandroid.intent.category.LAUNCHER]); if (launcher ! null) intentFilter.RemoveChild(launcher); } } private static XmlElement CreateActivityAlias(XmlDocument doc, string packageName, string iconName) { XmlElement alias doc.CreateElement(activity-alias); alias.SetAttribute(name, http://schemas.android.com/apk/res/android, .icon_ iconName); alias.SetAttribute(targetActivity, http://schemas.android.com/apk/res/android, com.unity3d.player.UnityPlayerActivity); alias.SetAttribute(enabled, http://schemas.android.com/apk/res/android, iconName default ? true : false); alias.SetAttribute(exported, http://schemas.android.com/apk/res/android, true); alias.SetAttribute(icon, http://schemas.android.com/apk/res/android, mipmap/app_icon_ iconName); alias.SetAttribute(label, http://schemas.android.com/apk/res/android, string/app_name); XmlElement intentFilter doc.CreateElement(intent-filter); XmlElement action doc.CreateElement(action); action.SetAttribute(name, http://schemas.android.com/apk/res/android, android.intent.action.MAIN); XmlElement category doc.CreateElement(category); category.SetAttribute(name, http://schemas.android.com/apk/res/android, android.intent.category.LAUNCHER); intentFilter.AppendChild(action); intentFilter.AppendChild(category); alias.AppendChild(intentFilter); return alias; } }這段代碼有幾個(gè)關(guān)鍵點(diǎn)PostProcessBuild的優(yōu)先級(jí)設(shè)為1000確保在其他后處理腳本之后執(zhí)行處理了Gradle工程和直接APK兩種構(gòu)建模式用XmlDocument操作而不是字符串替換避免格式錯(cuò)誤。3.3 iOS側(cè)PostprocessBuild修改Info.plist并拷貝圖標(biāo)iOS這邊更麻煩一點(diǎn)因?yàn)槌烁腎nfo.plist還要把圖標(biāo)文件拷貝到正確的位置。Unity構(gòu)建出來的Xcode工程Info.plist在Unity-iPhone/Info.plist圖標(biāo)需要拷貝到Unity-iPhone/根目錄下。using UnityEditor; using UnityEditor.Callbacks; using System.IO; using UnityEditor.iOS.Xcode; using UnityEngine; public class IOSIconPostprocessor { [PostProcessBuild(1000)] public static void OnPostprocessBuild(BuildTarget target, string pathToBuiltProject) { if (target ! BuildTarget.iOS) return; string plistPath Path.Combine(pathToBuiltProject, Info.plist); PlistDocument plist new PlistDocument(); plist.ReadFromFile(plistPath); PlistElementDict rootDict plist.root; PlistElementDict bundleIcons rootDict.CreateDict(CFBundleIcons); // 主圖標(biāo) PlistElementDict primaryIcon bundleIcons.CreateDict(CFBundlePrimaryIcon); PlistElementArray primaryFiles primaryIcon.CreateArray(CFBundleIconFiles); primaryFiles.AddString(AppIcon60x60); // 備選圖標(biāo) PlistElementDict alternateIcons bundleIcons.CreateDict(CFBundleAlternateIcons); string[] iconNames { festival, anniversary }; foreach (string iconName in iconNames) { PlistElementDict iconDict alternateIcons.CreateDict(iconName); PlistElementArray iconFiles iconDict.CreateArray(CFBundleIconFiles); iconFiles.AddString(AppIcon_ Capitalize(iconName) 60x60); iconDict.SetBoolean(UIPrerenderedIcon, false); } plist.WriteToFile(plistPath); // 拷貝圖標(biāo)文件到Bundle根目錄 string sourceDir Assets/Editor/DynamicIcons/iOS; string destDir pathToBuiltProject; foreach (string iconName in iconNames) { string baseName AppIcon_ Capitalize(iconName) 60x60; CopyIconFile(sourceDir, destDir, baseName .png); CopyIconFile(sourceDir, destDir, baseName 2x.png); CopyIconFile(sourceDir, destDir, baseName 3x.png); } Debug.Log(iOS動(dòng)態(tài)圖標(biāo)配置注入完成); } private static void CopyIconFile(string sourceDir, string destDir, string fileName) { string src Path.Combine(sourceDir, fileName); string dst Path.Combine(destDir, fileName); if (File.Exists(src)) { File.Copy(src, dst, true); } else { Debug.LogWarning(圖標(biāo)文件不存在: src); } } private static string Capitalize(string s) { if (string.IsNullOrEmpty(s)) return s; return char.ToUpper(s[0]) s.Substring(1); } }這里用了Unity的PlistDocument類來操作plist比直接改XML安全得多。圖標(biāo)文件我放在Assets/Editor/DynamicIcons/iOS/目錄下構(gòu)建時(shí)自動(dòng)拷貝。3.4 Unity與原生層的橋接Unity側(cè)要調(diào)用原生的切換方法需要做平臺(tái)判斷和橋接。Android用AndroidJavaObjectiOS用DllImport。using UnityEngine; public class DynamicIconManager : MonoBehaviour { public static void SwitchIcon(string iconName) { #if UNITY_ANDROID !UNITY_EDITOR using (AndroidJavaClass unityPlayer new AndroidJavaClass(com.unity3d.player.UnityPlayer)) using (AndroidJavaObject activity unityPlayer.GetStaticAndroidJavaObject(currentActivity)) { activity.Call(runOnUiThread, new AndroidJavaRunnable(() { activity.Call(switchIcon, icon_ iconName); })); } #elif UNITY_IOS !UNITY_EDITOR _SwitchIcon(iconName); #else Debug.Log(編輯器模式下不執(zhí)行圖標(biāo)切換: iconName); #endif } #if UNITY_IOS !UNITY_EDITOR [System.Runtime.InteropServices.DllImport(__Internal)] private static extern void _SwitchIcon(string iconName); #endif }iOS側(cè)需要一個(gè).mm文件來暴露C接口給Unity// DynamicIcon.mm #import UIKit/UIKit.h extern C { void _SwitchIcon(const char* iconName) { NSString *name [NSString stringWithUTF8String:iconName]; dispatch_async(dispatch_get_main_queue(), ^{ if (![UIApplication sharedApplication].supportsAlternateIcons) return; NSString *target [name isEqualToString:default] ? nil : name; [[UIApplication sharedApplication] setAlternateIconName:target completionHandler:^(NSError *error) { if (error) NSLog(切換圖標(biāo)失敗: %, error); }]; }); } }這個(gè).mm文件需要放在Assets/Plugins/iOS/目錄下Unity會(huì)自動(dòng)把它編譯進(jìn)Xcode工程。4. 實(shí)操全流程從資源準(zhǔn)備到出包驗(yàn)證4.1 圖標(biāo)資源規(guī)范與準(zhǔn)備Android和iOS對(duì)圖標(biāo)尺寸的要求不一樣我整理了一個(gè)對(duì)照表平臺(tái)用途尺寸命名規(guī)范存放位置Androidmipmap-mdpi48x48app_icon_default.pngAssets/Plugins/Android/res/mipmap-mdpi/Androidmipmap-hdpi72x72app_icon_default.pngAssets/Plugins/Android/res/mipmap-hdpi/Androidmipmap-xhdpi96x96app_icon_default.pngAssets/Plugins/Android/res/mipmap-xhdpi/Androidmipmap-xxhdpi144x144app_icon_default.pngAssets/Plugins/Android/res/mipmap-xxhdpi/Androidmipmap-xxxhdpi192x192app_icon_default.pngAssets/Plugins/Android/res/mipmap-xxxhdpi/iOS60x601x60x60AppIcon_Festival60x60.pngAssets/Editor/DynamicIcons/iOS/iOS60x602x120x120AppIcon_Festival60x602x.pngAssets/Editor/DynamicIcons/iOS/iOS60x603x180x180AppIcon_Festival60x603x.pngAssets/Editor/DynamicIcons/iOS/Android的圖標(biāo)放在Assets/Plugins/Android/res/下Unity構(gòu)建時(shí)會(huì)自動(dòng)合并到APK的res目錄。注意不要放在Assets/Resources/下那樣不會(huì)被打進(jìn)原生資源。iOS的圖標(biāo)命名有個(gè)坑CFBundleIconFiles里寫的是AppIcon_Festival60x60系統(tǒng)會(huì)自動(dòng)去找AppIcon_Festival60x60.png、AppIcon_Festival60x602x.png、AppIcon_Festival60x603x.png。所以命名必須嚴(yán)格一致大小寫敏感。4.2 構(gòu)建腳本的完整配置把上面兩個(gè)Postprocessor腳本放到Assets/Editor/目錄下Unity會(huì)自動(dòng)識(shí)別。但有幾個(gè)配置項(xiàng)需要確認(rèn)Player Settings → Publishing Settings → Build如果勾選了Custom Main ManifestUnity會(huì)用你提供的manifest而不是自動(dòng)生成。這種情況下你需要手動(dòng)在自定義manifest里加aliasPostprocessor腳本要相應(yīng)調(diào)整。Player Settings → Other Settings → Package Name確保包名正確alias的name會(huì)基于包名生成。iOS Player Settings → Icon這里配置的是主圖標(biāo)備選圖標(biāo)不走這里走我們的Postprocessor。我建議的做法是不勾選Custom Main Manifest讓Unity自動(dòng)生成然后Postprocessor在構(gòu)建后注入。這樣最省心。4.3 切換邏輯的時(shí)機(jī)與狀態(tài)管理圖標(biāo)切換不是隨便什么時(shí)候都能調(diào)的。我的經(jīng)驗(yàn)是不要在App啟動(dòng)時(shí)立即切換。啟動(dòng)階段系統(tǒng)資源緊張切換容易失敗。建議在進(jìn)入主界面后延遲1-2秒再執(zhí)行。切換狀態(tài)要持久化。用PlayerPrefs記錄當(dāng)前圖標(biāo)名下次啟動(dòng)時(shí)對(duì)比服務(wù)端下發(fā)的配置如果一致就不重復(fù)切換避免不必要的閃動(dòng)和彈窗。切換前檢查網(wǎng)絡(luò)和資源。如果圖標(biāo)資源是熱更下載的Android可以iOS不行因?yàn)閳D標(biāo)必須打包進(jìn)Bundle要確保下載完成再切換。public class IconSwitchController : MonoBehaviour { private const string ICON_KEY current_icon_name; void Start() { Invoke(CheckAndSwitchIcon, 2f); } private void CheckAndSwitchIcon() { string serverIcon GetServerIconConfig(); // 從服務(wù)端或本地配置讀取 string localIcon PlayerPrefs.GetString(ICON_KEY, default); if (serverIcon ! localIcon) { DynamicIconManager.SwitchIcon(serverIcon); PlayerPrefs.SetString(ICON_KEY, serverIcon); PlayerPrefs.Save(); } } }4.4 出包驗(yàn)證清單出包后別急著發(fā)按這個(gè)清單過一遍Android安裝后桌面圖標(biāo)是否正常顯示默認(rèn)圖標(biāo)用adb shell dumpsys package 包名查看alias的enabled狀態(tài)是否正確。Android調(diào)用切換后桌面圖標(biāo)是否變成目標(biāo)圖標(biāo)殺掉App重開圖標(biāo)是否保持Android切換時(shí)App是否被殺掉如果被殺檢查DONT_KILL_APP標(biāo)志是否傳了。iOS安裝后圖標(biāo)是否正常切換時(shí)是否彈出系統(tǒng)提示切換后圖標(biāo)是否變化iOS殺掉App重開圖標(biāo)是否保持恢復(fù)默認(rèn)圖標(biāo)是否正常雙端連續(xù)切換多次是否有異常圖標(biāo)資源是否都正確打包5. 常見問題與排查技巧實(shí)錄5.1 Android端典型問題問題一桌面上出現(xiàn)兩個(gè)圖標(biāo)。這是最常見的問題。原因通常是主Activity的intent-filter里還保留著LAUNCHER category。檢查AndroidManifest.xml確保主Activity的intent-filter里只有MAIN action沒有LAUNCHER category。另外檢查是否有多個(gè)alias同時(shí)處于enabled狀態(tài)。問題二切換后圖標(biāo)沒變但alias狀態(tài)變了。這種情況通常是launcher緩存導(dǎo)致的。不同廠商的launcher刷新機(jī)制不一樣小米和華為一般會(huì)立即刷新OPPO和vivo可能有延遲。解決辦法是切換后發(fā)一個(gè)廣播通知launcher刷新但這不是標(biāo)準(zhǔn)API各廠商支持情況不一。我的做法是切換后彈一個(gè)Toast提示用戶圖標(biāo)將在幾秒后更新給用戶預(yù)期。問題三切換時(shí)App閃退。檢查是否在主線程調(diào)用setComponentEnabledSetting。這個(gè)API必須在主線程執(zhí)行。另外檢查alias的name是否拼寫正確ComponentName的第二個(gè)參數(shù)必須是完整類名包名alias名。問題四某些機(jī)型上alias不生效。部分定制ROM尤其是早期的EMUI和MIUI對(duì)activity-alias的支持有問題。實(shí)測下來Android 7.0以上的主流機(jī)型基本沒問題Android 5.x和6.x的部分機(jī)型可能有兼容性問題。如果目標(biāo)用戶里老機(jī)型占比高建議做降級(jí)處理檢測切換是否成功失敗則提示用戶手動(dòng)更換。5.2 iOS端典型問題問題一切換時(shí)報(bào)錯(cuò)icon name not found。檢查三件事Info.plist里CFBundleAlternateIcons的key是否和傳入的name一致圖標(biāo)文件是否在Bundle根目錄下不是Assets.xcassets文件名是否和CFBundleIconFiles里聲明的一致包括2x、3x后綴。問題二切換時(shí)彈窗提示您已更改圖標(biāo)能否去掉不能。這是iOS的系統(tǒng)行為公開API無法繞過。有些團(tuán)隊(duì)嘗試用UIAlertController的私有方法去攔截但在iOS 13以后已經(jīng)失效。接受它或者在產(chǎn)品層面引導(dǎo)用戶比如切換前先彈一個(gè)自定義提示說明會(huì)有一個(gè)系統(tǒng)彈窗。問題三審核時(shí)被拒說動(dòng)態(tài)圖標(biāo)功能不明確。App Store審核指南對(duì)動(dòng)態(tài)圖標(biāo)沒有明確禁止但如果你的App切換圖標(biāo)后功能沒有變化審核員可能認(rèn)為這是無意義的功能。建議在審核時(shí)提供說明動(dòng)態(tài)圖標(biāo)用于節(jié)日活動(dòng)或用戶個(gè)性化并在App內(nèi)提供明確的切換入口。問題四iPad上不生效。iPad的圖標(biāo)尺寸和iPhone不一樣CFBundleIconFiles需要額外聲明iPad的尺寸如AppIcon_Festival76x76。如果只聲明了60x60iPad上可能不生效。建議同時(shí)聲明iPhone和iPad的圖標(biāo)尺寸。5.3 雙端通用問題速查表問題現(xiàn)象可能原因排查方向解決方案切換后圖標(biāo)不變資源未打包檢查APK/Bundle里是否有圖標(biāo)文件確認(rèn)資源路徑正確切換后App重啟未傳DONT_KILL_APP檢查Android代碼加上標(biāo)志iOS切換報(bào)錯(cuò)plist配置錯(cuò)誤檢查CFBundleAlternateIcons修正key和文件名桌面出現(xiàn)雙圖標(biāo)LAUNCHER category重復(fù)檢查manifest移除主Activity的LAUNCHER切換狀態(tài)丟失未持久化檢查PlayerPrefs切換后立即Save部分機(jī)型不生效ROM兼容性查看系統(tǒng)版本做降級(jí)提示5.4 我踩過的幾個(gè)坑第一個(gè)坑是Android的alias name用了絕對(duì)路徑。一開始我寫的是com.example.game.icon_default結(jié)果在某些機(jī)型上不生效。后來改成相對(duì)路徑.icon_default讓系統(tǒng)自動(dòng)拼包名問題解決。原因是絕對(duì)路徑在某些ROM上會(huì)被當(dāng)成不同的組件處理。第二個(gè)坑是iOS圖標(biāo)文件放進(jìn)了Assets.xcassets。Xcode的Asset Catalog會(huì)把圖標(biāo)編譯成Assets.carsetAlternateIconName根本找不到。必須用folder reference的方式直接放Bundle根目錄。第三個(gè)坑是Unity構(gòu)建時(shí)覆蓋了Info.plist。我一開始在Xcode里手動(dòng)改了plist結(jié)果Unity重新構(gòu)建后全沒了。后來用Postprocessor腳本自動(dòng)注入才徹底解決。第四個(gè)坑是切換時(shí)機(jī)太早。在Awake里調(diào)用切換Android上經(jīng)常失敗因?yàn)锳ctivity還沒完全初始化。改成延遲2秒后調(diào)用穩(wěn)定了。6. 工程化擴(kuò)展與進(jìn)階玩法6.1 圖標(biāo)配置表驅(qū)動(dòng)硬編碼圖標(biāo)名不是好做法。我建議用ScriptableObject做配置表把圖標(biāo)名、資源路徑、生效時(shí)間、平臺(tái)限制都配置化。[CreateAssetMenu(fileName IconConfig, menuName DynamicIcon/IconConfig)] public class IconConfig : ScriptableObject { [System.Serializable] public class IconEntry { public string iconName; public string displayName; public long startTime; public long endTime; public bool enableAndroid; public bool enableIOS; } public ListIconEntry icons new ListIconEntry(); public string GetActiveIcon(long currentTime) { foreach (var icon in icons) { if (currentTime icon.startTime currentTime icon.endTime) return icon.iconName; } return default; } }這樣運(yùn)營配置活動(dòng)時(shí)只需要改配置表不需要改代碼。6.2 服務(wù)端下發(fā)與灰度圖標(biāo)切換的配置最好走服務(wù)端下發(fā)這樣可以隨時(shí)調(diào)整活動(dòng)時(shí)間不需要發(fā)版。服務(wù)端返回一個(gè)JSON客戶端解析后對(duì)比本地狀態(tài)決定是否切換。灰度方面可以按用戶ID哈?；蛘咔腊鼇砜刂颇男┯脩魠⑴c。6.3 與熱更系統(tǒng)的配合Android的圖標(biāo)資源可以走熱更因?yàn)閍lias的icon屬性可以指向下載到本地的資源實(shí)際上不行alias的icon必須是打包進(jìn)APK的資源。所以Android的備選圖標(biāo)也必須預(yù)先打包進(jìn)APK不能熱更。這一點(diǎn)和iOS一樣。所以動(dòng)態(tài)圖標(biāo)的動(dòng)態(tài)指的是切換時(shí)機(jī)動(dòng)態(tài)而不是圖標(biāo)資源動(dòng)態(tài)。這個(gè)認(rèn)知很重要很多團(tuán)隊(duì)一開始以為可以熱更圖標(biāo)結(jié)果發(fā)現(xiàn)不行。如果確實(shí)需要大量圖標(biāo)比如用戶自定義圖標(biāo)Android可以通過PackageManager的setComponentEnabledSetting配合動(dòng)態(tài)生成的alias來實(shí)現(xiàn)但需要反射調(diào)用隱藏API風(fēng)險(xiǎn)較高不建議。6.4 用戶體驗(yàn)優(yōu)化建議切換圖標(biāo)這件事用戶感知很強(qiáng)但也很容易做成騷擾。我的建議是給用戶選擇權(quán)。不要強(qiáng)制切換在設(shè)置里提供圖標(biāo)選擇入口讓用戶自己選。切換前告知。尤其是iOS系統(tǒng)彈窗會(huì)讓用戶困惑提前用自定義彈窗說明。提供恢復(fù)默認(rèn)的入口。用戶換了圖標(biāo)后想換回來要能方便地找到。不要頻繁切換。一天切好幾次會(huì)讓用戶覺得App不穩(wěn)定。我在實(shí)際項(xiàng)目里的做法是默認(rèn)圖標(biāo)保持不變只在重大活動(dòng)時(shí)通過服務(wù)端配置切換活動(dòng)結(jié)束后自動(dòng)恢復(fù)。同時(shí)在設(shè)置里提供圖標(biāo)樣式選項(xiàng)讓喜歡個(gè)性化的用戶自己選。這樣既保證了運(yùn)營效果又不打擾普通用戶。最后分享一個(gè)小技巧Android端可以在切換后發(fā)一個(gè)自定義廣播Intent.ACTION_PACKAGE_CHANGED部分launcher會(huì)響應(yīng)這個(gè)廣播刷新圖標(biāo)能減少圖標(biāo)閃動(dòng)的時(shí)間。但這個(gè)廣播不是所有l(wèi)auncher都認(rèn)只能算錦上添花。iOS端則可以在切換完成后用UIApplication.shared.applicationIconBadgeNumber觸發(fā)一次刷新有時(shí)候能讓圖標(biāo)更快更新但效果不穩(wěn)定看系統(tǒng)版本。