圖標雙端工程化方案：Android activity-alias與iOS setAlternateIconName實戰(zhàn))
1. 動態(tài)圖標這件事到底在解決什么問題做過手游運營的人都有一個共識App圖標是成本最低、觸達最廣的運營位。它不需要用戶打開游戲不需要推送權(quán)限甚至不需要用戶在線——只要圖標躺在手機桌面上每一次解鎖屏幕都是一次曝光。春節(jié)換紅底、周年慶換金色、聯(lián)動活動換角色立繪這套玩法在國內(nèi)頭部手游里早就跑通了。但問題在于Unity作為跨平臺引擎本身并沒有提供一套統(tǒng)一的動態(tài)圖標API。Android和iOS兩端的實現(xiàn)路徑完全不同Android靠activity-alias做組件切換iOS靠setAlternateIconName做系統(tǒng)級替換。更麻煩的是Unity的構(gòu)建流程會覆蓋原生工程配置你手動改的東西下一次出包就沒了。所以真正要解決的不是怎么換圖標這個單點問題而是怎么在Unity的構(gòu)建管線里把雙端的動態(tài)圖標能力做成可配置、可自動化、不丟配置的工程化方案。這篇文章適合三類人看一是正在做手游運營功能開發(fā)的同學二是需要給項目加動態(tài)圖標但不知道從哪下手的Unity客戶端三是想了解Androidactivity-alias和iOS alternate icon底層機制的移動端開發(fā)者。我會把兩端的原理、Unity側(cè)的工程改造、構(gòu)建腳本、踩過的坑全部攤開講代碼和配置都可以直接抄。先說結(jié)論Android端用activity-alias方案切換時會有一次桌面圖標的閃動系統(tǒng)會短暫移除再添加組件但兼容性最好從Android 5.0到14都沒問題iOS端用setAlternateIconName切換時系統(tǒng)會彈一個您已更改圖標的提示框這個提示無法繞過除非用私有API不建議。兩端都需要在Unity構(gòu)建后處理原生工程文件這部分我用Editor腳本自動化掉了。2. 雙端方案選型為什么Android用activity-aliasiOS用setAlternateIconName2.1 Android端activity-alias是唯一靠譜的路Android換圖標這件事網(wǎng)上能搜到好幾種說法我一個個說清楚為什么最后選了activity-alias。第一種是直接改AndroidManifest.xml里application的android:icon屬性然后重新安裝。這顯然不行用戶不可能為了換個圖標重新下載APK。第二種是用PackageManager.setComponentEnabledSetting動態(tài)啟用/禁用組件。這個API本身沒問題關(guān)鍵在于你要啟用/禁用什么組件。Android的桌面圖標本質(zhì)上是一個activity組件帶LAUNCHERcategory的那個你沒法直接替換一個activity的圖標但你可以通過activity-alias創(chuàng)建多個別名每個別名指向同一個主Activity但各自帶不同的android:icon。然后通過setComponentEnabledSetting控制哪個別名處于啟用狀態(tài)。具體來說主Activity保持android:enabledfalse且不帶LAUNCHER category然后為每個圖標創(chuàng)建一個activity-alias只有當前選中的那個alias是enabledtrue且?guī)AUNCHER category。切換圖標 禁用舊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這里有幾個必須注意的細節(jié)我踩過坑主Activity的intent-filter里不能有LAUNCHER category否則桌面上會出現(xiàn)兩個圖標。只保留MAIN action即可。每個alias的android:name建議用相對路徑如.icon_default這樣會自動拼上包名避免硬編碼包名出錯。android:enabled的初始狀態(tài)默認圖標那個alias設為true其他全部false。這個狀態(tài)會被系統(tǒng)持久化用戶重啟手機也不會丟。切換時用PackageManager.setComponentEnabledSetting必須傳DONT_KILL_APP標志否則切換的瞬間你的進程會被殺掉用戶體驗極差。// 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 ); } // 啟用目標alias pm.setComponentEnabledSetting( new ComponentName(pkg, pkg . aliasName), PackageManager.COMPONENT_ENABLED_STATE_ENABLED, PackageManager.DONT_KILL_APP ); }實測下來這個方案在小米、華為、OPPO、vivo、三星的主流機型上都能正常工作。唯一的問題是切換瞬間桌面圖標會有一個短暫的消失再出現(xiàn)的過程這是系統(tǒng)launcher重新加載組件導致的無法避免。我的做法是在切換前給用戶一個loading提示切換完成后彈一個Toast讓用戶知道發(fā)生了什么。2.2 iOS端setAlternateIconName的能與不能iOS從10.3開始提供了setAlternateIconName:completionHandler:這個API允許App在運行時切換圖標。但蘋果對這個功能加了很多限制你必須提前知道第一所有備選圖標必須在Info.plist里預先聲明。你不能在運行時動態(tài)生成圖標只能從預先打包進Bundle的圖標里選。聲明方式是在Info.plist里加一個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第二圖標文件必須放在Bundle根目錄下不能放在Assets.xcassets里。這是最容易踩的坑。Xcode的Asset Catalog雖然方便但setAlternateIconName只認Bundle根目錄下的png文件。你需要把備選圖標以AppIcon_Festival60x60.png、AppIcon_Festival60x602x.png、AppIcon_Festival60x603x.png的命名方式直接拖進Xcode工程選擇Create folder references而不是Create groups。第三切換時會彈系統(tǒng)提示框。這是iOS的硬性行為提示內(nèi)容大概是您已更改XXX的圖標。這個提示無法通過公開API繞過。有些團隊用UIApplication.shared.isStatusBarHidden之類的hack去遮蓋但在新版本iOS上已經(jīng)失效了不建議折騰。第四切換必須在主線程調(diào)用且completionHandler里要處理錯誤。如果圖標名不存在或者文件缺失會返回error。// iOS側(cè)切換代碼 - (void)switchIcon:(NSString *)iconName { if (![UIApplication sharedApplication].supportsAlternateIcons) { NSLog(當前設備不支持切換圖標); return; } NSString *targetName [iconName isEqualToString:default] ? nil : iconName; [[UIApplication sharedApplication] setAlternateIconName:targetName completionHandler:^(NSError * _Nullable error) { if (error) { NSLog(切換圖標失敗: %, error.localizedDescription); } else { NSLog(切換圖標成功); } }]; }注意傳nil表示恢復默認圖標。另外supportsAlternateIcons這個屬性在iOS 10.3才可用低版本要加可用性判斷。2.3 兩端方案對比對比項Android (activity-alias)iOS (setAlternateIconName)最低支持版本Android 5.0iOS 10.3圖標來源打包進APK的mipmap資源打包進Bundle的png文件切換時系統(tǒng)提示無但桌面圖標會閃動有彈窗無法繞過是否需要重啟App否否圖標數(shù)量限制理論上無限制建議不超過10個審核風險無需在審核時說明用途3. Unity工程側(cè)改造讓構(gòu)建管線自動處理原生配置3.1 為什么不能手動改原生工程Unity的構(gòu)建流程是這樣的每次Build它都會重新生成Android的AndroidManifest.xml和iOS的Info.plist或者至少覆蓋你手動改的部分。你這次手動加了activity-alias下次出包就沒了。所以必須把配置注入到Unity的構(gòu)建管線里。Unity提供了兩個關(guān)鍵接口IPreprocessBuildWithReport和IPostprocessBuildWithReport。前者在構(gòu)建前執(zhí)行后者在構(gòu)建后執(zhí)行。對于Android我們需要在構(gòu)建后修改AndroidManifest.xml因為Unity生成的manifest在構(gòu)建后才最終確定對于iOS我們需要在構(gòu)建后修改Info.plist并拷貝圖標文件。3.2 Android側(cè)PostprocessBuild注入activity-aliasAndroid的manifest處理有個坑Unity構(gòu)建出來的工程AndroidManifest.xml在Temp/StagingArea目錄下構(gòu)建完成后會被拷貝到最終的Gradle工程里。我們需要在OnPostprocessBuild里找到這個文件并修改。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設置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動態(tài)圖標配置注入完成); } 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; } }這段代碼有幾個關(guān)鍵點PostProcessBuild的優(yōu)先級設為1000確保在其他后處理腳本之后執(zhí)行處理了Gradle工程和直接APK兩種構(gòu)建模式用XmlDocument操作而不是字符串替換避免格式錯誤。3.3 iOS側(cè)PostprocessBuild修改Info.plist并拷貝圖標iOS這邊更麻煩一點因為除了改Info.plist還要把圖標文件拷貝到正確的位置。Unity構(gòu)建出來的Xcode工程Info.plist在Unity-iPhone/Info.plist圖標需要拷貝到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); // 主圖標 PlistElementDict primaryIcon bundleIcons.CreateDict(CFBundlePrimaryIcon); PlistElementArray primaryFiles primaryIcon.CreateArray(CFBundleIconFiles); primaryFiles.AddString(AppIcon60x60); // 備選圖標 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); // 拷貝圖標文件到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動態(tài)圖標配置注入完成); } 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(圖標文件不存在: 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安全得多。圖標文件我放在Assets/Editor/DynamicIcons/iOS/目錄下構(gòu)建時自動拷貝。3.4 Unity與原生層的橋接Unity側(cè)要調(diào)用原生的切換方法需要做平臺判斷和橋接。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í)行圖標切換: iconName); #endif } #if UNITY_IOS !UNITY_EDITOR [System.Runtime.InteropServices.DllImport(__Internal)] private static extern void _SwitchIcon(string iconName); #endif }iOS側(cè)需要一個.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(切換圖標失敗: %, error); }]; }); } }這個.mm文件需要放在Assets/Plugins/iOS/目錄下Unity會自動把它編譯進Xcode工程。4. 實操全流程從資源準備到出包驗證4.1 圖標資源規(guī)范與準備Android和iOS對圖標尺寸的要求不一樣我整理了一個對照表平臺用途尺寸命名規(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的圖標放在Assets/Plugins/Android/res/下Unity構(gòu)建時會自動合并到APK的res目錄。注意不要放在Assets/Resources/下那樣不會被打進原生資源。iOS的圖標命名有個坑CFBundleIconFiles里寫的是AppIcon_Festival60x60系統(tǒng)會自動去找AppIcon_Festival60x60.png、AppIcon_Festival60x602x.png、AppIcon_Festival60x603x.png。所以命名必須嚴格一致大小寫敏感。4.2 構(gòu)建腳本的完整配置把上面兩個Postprocessor腳本放到Assets/Editor/目錄下Unity會自動識別。但有幾個配置項需要確認Player Settings → Publishing Settings → Build如果勾選了Custom Main ManifestUnity會用你提供的manifest而不是自動生成。這種情況下你需要手動在自定義manifest里加aliasPostprocessor腳本要相應調(diào)整。Player Settings → Other Settings → Package Name確保包名正確alias的name會基于包名生成。iOS Player Settings → Icon這里配置的是主圖標備選圖標不走這里走我們的Postprocessor。我建議的做法是不勾選Custom Main Manifest讓Unity自動生成然后Postprocessor在構(gòu)建后注入。這樣最省心。4.3 切換邏輯的時機與狀態(tài)管理圖標切換不是隨便什么時候都能調(diào)的。我的經(jīng)驗是不要在App啟動時立即切換。啟動階段系統(tǒng)資源緊張切換容易失敗。建議在進入主界面后延遲1-2秒再執(zhí)行。切換狀態(tài)要持久化。用PlayerPrefs記錄當前圖標名下次啟動時對比服務端下發(fā)的配置如果一致就不重復切換避免不必要的閃動和彈窗。切換前檢查網(wǎng)絡和資源。如果圖標資源是熱更下載的Android可以iOS不行因為圖標必須打包進Bundle要確保下載完成再切換。public class IconSwitchController : MonoBehaviour { private const string ICON_KEY current_icon_name; void Start() { Invoke(CheckAndSwitchIcon, 2f); } private void CheckAndSwitchIcon() { string serverIcon GetServerIconConfig(); // 從服務端或本地配置讀取 string localIcon PlayerPrefs.GetString(ICON_KEY, default); if (serverIcon ! localIcon) { DynamicIconManager.SwitchIcon(serverIcon); PlayerPrefs.SetString(ICON_KEY, serverIcon); PlayerPrefs.Save(); } } }4.4 出包驗證清單出包后別急著發(fā)按這個清單過一遍Android安裝后桌面圖標是否正常顯示默認圖標用adb shell dumpsys package 包名查看alias的enabled狀態(tài)是否正確。Android調(diào)用切換后桌面圖標是否變成目標圖標殺掉App重開圖標是否保持Android切換時App是否被殺掉如果被殺檢查DONT_KILL_APP標志是否傳了。iOS安裝后圖標是否正常切換時是否彈出系統(tǒng)提示切換后圖標是否變化iOS殺掉App重開圖標是否保持恢復默認圖標是否正常雙端連續(xù)切換多次是否有異常圖標資源是否都正確打包5. 常見問題與排查技巧實錄5.1 Android端典型問題問題一桌面上出現(xiàn)兩個圖標。這是最常見的問題。原因通常是主Activity的intent-filter里還保留著LAUNCHER category。檢查AndroidManifest.xml確保主Activity的intent-filter里只有MAIN action沒有LAUNCHER category。另外檢查是否有多個alias同時處于enabled狀態(tài)。問題二切換后圖標沒變但alias狀態(tài)變了。這種情況通常是launcher緩存導致的。不同廠商的launcher刷新機制不一樣小米和華為一般會立即刷新OPPO和vivo可能有延遲。解決辦法是切換后發(fā)一個廣播通知launcher刷新但這不是標準API各廠商支持情況不一。我的做法是切換后彈一個Toast提示用戶圖標將在幾秒后更新給用戶預期。問題三切換時App閃退。檢查是否在主線程調(diào)用setComponentEnabledSetting。這個API必須在主線程執(zhí)行。另外檢查alias的name是否拼寫正確ComponentName的第二個參數(shù)必須是完整類名包名alias名。問題四某些機型上alias不生效。部分定制ROM尤其是早期的EMUI和MIUI對activity-alias的支持有問題。實測下來Android 7.0以上的主流機型基本沒問題Android 5.x和6.x的部分機型可能有兼容性問題。如果目標用戶里老機型占比高建議做降級處理檢測切換是否成功失敗則提示用戶手動更換。5.2 iOS端典型問題問題一切換時報錯icon name not found。檢查三件事Info.plist里CFBundleAlternateIcons的key是否和傳入的name一致圖標文件是否在Bundle根目錄下不是Assets.xcassets文件名是否和CFBundleIconFiles里聲明的一致包括2x、3x后綴。問題二切換時彈窗提示您已更改圖標能否去掉不能。這是iOS的系統(tǒng)行為公開API無法繞過。有些團隊嘗試用UIAlertController的私有方法去攔截但在iOS 13以后已經(jīng)失效。接受它或者在產(chǎn)品層面引導用戶比如切換前先彈一個自定義提示說明會有一個系統(tǒng)彈窗。問題三審核時被拒說動態(tài)圖標功能不明確。App Store審核指南對動態(tài)圖標沒有明確禁止但如果你的App切換圖標后功能沒有變化審核員可能認為這是無意義的功能。建議在審核時提供說明動態(tài)圖標用于節(jié)日活動或用戶個性化并在App內(nèi)提供明確的切換入口。問題四iPad上不生效。iPad的圖標尺寸和iPhone不一樣CFBundleIconFiles需要額外聲明iPad的尺寸如AppIcon_Festival76x76。如果只聲明了60x60iPad上可能不生效。建議同時聲明iPhone和iPad的圖標尺寸。5.3 雙端通用問題速查表問題現(xiàn)象可能原因排查方向解決方案切換后圖標不變資源未打包檢查APK/Bundle里是否有圖標文件確認資源路徑正確切換后App重啟未傳DONT_KILL_APP檢查Android代碼加上標志iOS切換報錯plist配置錯誤檢查CFBundleAlternateIcons修正key和文件名桌面出現(xiàn)雙圖標LAUNCHER category重復檢查manifest移除主Activity的LAUNCHER切換狀態(tài)丟失未持久化檢查PlayerPrefs切換后立即Save部分機型不生效ROM兼容性查看系統(tǒng)版本做降級提示5.4 我踩過的幾個坑第一個坑是Android的alias name用了絕對路徑。一開始我寫的是com.example.game.icon_default結(jié)果在某些機型上不生效。后來改成相對路徑.icon_default讓系統(tǒng)自動拼包名問題解決。原因是絕對路徑在某些ROM上會被當成不同的組件處理。第二個坑是iOS圖標文件放進了Assets.xcassets。Xcode的Asset Catalog會把圖標編譯成Assets.carsetAlternateIconName根本找不到。必須用folder reference的方式直接放Bundle根目錄。第三個坑是Unity構(gòu)建時覆蓋了Info.plist。我一開始在Xcode里手動改了plist結(jié)果Unity重新構(gòu)建后全沒了。后來用Postprocessor腳本自動注入才徹底解決。第四個坑是切換時機太早。在Awake里調(diào)用切換Android上經(jīng)常失敗因為Activity還沒完全初始化。改成延遲2秒后調(diào)用穩(wěn)定了。6. 工程化擴展與進階玩法6.1 圖標配置表驅(qū)動硬編碼圖標名不是好做法。我建議用ScriptableObject做配置表把圖標名、資源路徑、生效時間、平臺限制都配置化。[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; } }這樣運營配置活動時只需要改配置表不需要改代碼。6.2 服務端下發(fā)與灰度圖標切換的配置最好走服務端下發(fā)這樣可以隨時調(diào)整活動時間不需要發(fā)版。服務端返回一個JSON客戶端解析后對比本地狀態(tài)決定是否切換?；叶确矫婵梢园从脩鬒D哈?；蛘咔腊鼇砜刂颇男┯脩魠⑴c。6.3 與熱更系統(tǒng)的配合Android的圖標資源可以走熱更因為alias的icon屬性可以指向下載到本地的資源實際上不行alias的icon必須是打包進APK的資源。所以Android的備選圖標也必須預先打包進APK不能熱更。這一點和iOS一樣。所以動態(tài)圖標的動態(tài)指的是切換時機動態(tài)而不是圖標資源動態(tài)。這個認知很重要很多團隊一開始以為可以熱更圖標結(jié)果發(fā)現(xiàn)不行。如果確實需要大量圖標比如用戶自定義圖標Android可以通過PackageManager的setComponentEnabledSetting配合動態(tài)生成的alias來實現(xiàn)但需要反射調(diào)用隱藏API風險較高不建議。6.4 用戶體驗優(yōu)化建議切換圖標這件事用戶感知很強但也很容易做成騷擾。我的建議是給用戶選擇權(quán)。不要強制切換在設置里提供圖標選擇入口讓用戶自己選。切換前告知。尤其是iOS系統(tǒng)彈窗會讓用戶困惑提前用自定義彈窗說明。提供恢復默認的入口。用戶換了圖標后想換回來要能方便地找到。不要頻繁切換。一天切好幾次會讓用戶覺得App不穩(wěn)定。我在實際項目里的做法是默認圖標保持不變只在重大活動時通過服務端配置切換活動結(jié)束后自動恢復。同時在設置里提供圖標樣式選項讓喜歡個性化的用戶自己選。這樣既保證了運營效果又不打擾普通用戶。最后分享一個小技巧Android端可以在切換后發(fā)一個自定義廣播Intent.ACTION_PACKAGE_CHANGED部分launcher會響應這個廣播刷新圖標能減少圖標閃動的時間。但這個廣播不是所有l(wèi)auncher都認只能算錦上添花。iOS端則可以在切換完成后用UIApplication.shared.applicationIconBadgeNumber觸發(fā)一次刷新有時候能讓圖標更快更新但效果不穩(wěn)定看系統(tǒng)版本。 Unity手游動態(tài)圖標雙端工程化方案：Android activity-alias與iOS setAlternateIconName實戰(zhàn)
1. 動態(tài)圖標這件事到底在解決什么問題做過手游運營的人都有一個共識App圖標是成本最低、觸達最廣的運營位。它不需要用戶打開游戲不需要推送權(quán)限甚至不需要用戶在線——只要圖標躺在手機桌面上每一次解鎖屏幕都是一次曝光。春節(jié)換紅底、周年慶換金色、聯(lián)動活動換角色立繪這套玩法在國內(nèi)頭部手游里早就跑通了。但問題在于Unity作為跨平臺引擎本身并沒有提供一套統(tǒng)一的動態(tài)圖標API。Android和iOS兩端的實現(xiàn)路徑完全不同Android靠activity-alias做組件切換iOS靠setAlternateIconName做系統(tǒng)級替換。更麻煩的是Unity的構(gòu)建流程會覆蓋原生工程配置你手動改的東西下一次出包就沒了。所以真正要解決的不是怎么換圖標這個單點問題而是怎么在Unity的構(gòu)建管線里把雙端的動態(tài)圖標能力做成可配置、可自動化、不丟配置的工程化方案。這篇文章適合三類人看一是正在做手游運營功能開發(fā)的同學二是需要給項目加動態(tài)圖標但不知道從哪下手的Unity客戶端三是想了解Androidactivity-alias和iOS alternate icon底層機制的移動端開發(fā)者。我會把兩端的原理、Unity側(cè)的工程改造、構(gòu)建腳本、踩過的坑全部攤開講代碼和配置都可以直接抄。先說結(jié)論Android端用activity-alias方案切換時會有一次桌面圖標的閃動系統(tǒng)會短暫移除再添加組件但兼容性最好從Android 5.0到14都沒問題iOS端用setAlternateIconName切換時系統(tǒng)會彈一個您已更改圖標的提示框這個提示無法繞過除非用私有API不建議。兩端都需要在Unity構(gòu)建后處理原生工程文件這部分我用Editor腳本自動化掉了。2. 雙端方案選型為什么Android用activity-aliasiOS用setAlternateIconName2.1 Android端activity-alias是唯一靠譜的路Android換圖標這件事網(wǎng)上能搜到好幾種說法我一個個說清楚為什么最后選了activity-alias。第一種是直接改AndroidManifest.xml里application的android:icon屬性然后重新安裝。這顯然不行用戶不可能為了換個圖標重新下載APK。第二種是用PackageManager.setComponentEnabledSetting動態(tài)啟用/禁用組件。這個API本身沒問題關(guān)鍵在于你要啟用/禁用什么組件。Android的桌面圖標本質(zhì)上是一個activity組件帶LAUNCHERcategory的那個你沒法直接替換一個activity的圖標但你可以通過activity-alias創(chuàng)建多個別名每個別名指向同一個主Activity但各自帶不同的android:icon。然后通過setComponentEnabledSetting控制哪個別名處于啟用狀態(tài)。具體來說主Activity保持android:enabledfalse且不帶LAUNCHER category然后為每個圖標創(chuàng)建一個activity-alias只有當前選中的那個alias是enabledtrue且?guī)AUNCHER category。切換圖標 禁用舊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這里有幾個必須注意的細節(jié)我踩過坑主Activity的intent-filter里不能有LAUNCHER category否則桌面上會出現(xiàn)兩個圖標。只保留MAIN action即可。每個alias的android:name建議用相對路徑如.icon_default這樣會自動拼上包名避免硬編碼包名出錯。android:enabled的初始狀態(tài)默認圖標那個alias設為true其他全部false。這個狀態(tài)會被系統(tǒng)持久化用戶重啟手機也不會丟。切換時用PackageManager.setComponentEnabledSetting必須傳DONT_KILL_APP標志否則切換的瞬間你的進程會被殺掉用戶體驗極差。// 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 ); } // 啟用目標alias pm.setComponentEnabledSetting( new ComponentName(pkg, pkg . aliasName), PackageManager.COMPONENT_ENABLED_STATE_ENABLED, PackageManager.DONT_KILL_APP ); }實測下來這個方案在小米、華為、OPPO、vivo、三星的主流機型上都能正常工作。唯一的問題是切換瞬間桌面圖標會有一個短暫的消失再出現(xiàn)的過程這是系統(tǒng)launcher重新加載組件導致的無法避免。我的做法是在切換前給用戶一個loading提示切換完成后彈一個Toast讓用戶知道發(fā)生了什么。2.2 iOS端setAlternateIconName的能與不能iOS從10.3開始提供了setAlternateIconName:completionHandler:這個API允許App在運行時切換圖標。但蘋果對這個功能加了很多限制你必須提前知道第一所有備選圖標必須在Info.plist里預先聲明。你不能在運行時動態(tài)生成圖標只能從預先打包進Bundle的圖標里選。聲明方式是在Info.plist里加一個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第二圖標文件必須放在Bundle根目錄下不能放在Assets.xcassets里。這是最容易踩的坑。Xcode的Asset Catalog雖然方便但setAlternateIconName只認Bundle根目錄下的png文件。你需要把備選圖標以AppIcon_Festival60x60.png、AppIcon_Festival60x602x.png、AppIcon_Festival60x603x.png的命名方式直接拖進Xcode工程選擇Create folder references而不是Create groups。第三切換時會彈系統(tǒng)提示框。這是iOS的硬性行為提示內(nèi)容大概是您已更改XXX的圖標。這個提示無法通過公開API繞過。有些團隊用UIApplication.shared.isStatusBarHidden之類的hack去遮蓋但在新版本iOS上已經(jīng)失效了不建議折騰。第四切換必須在主線程調(diào)用且completionHandler里要處理錯誤。如果圖標名不存在或者文件缺失會返回error。// iOS側(cè)切換代碼 - (void)switchIcon:(NSString *)iconName { if (![UIApplication sharedApplication].supportsAlternateIcons) { NSLog(當前設備不支持切換圖標); return; } NSString *targetName [iconName isEqualToString:default] ? nil : iconName; [[UIApplication sharedApplication] setAlternateIconName:targetName completionHandler:^(NSError * _Nullable error) { if (error) { NSLog(切換圖標失敗: %, error.localizedDescription); } else { NSLog(切換圖標成功); } }]; }注意傳nil表示恢復默認圖標。另外supportsAlternateIcons這個屬性在iOS 10.3才可用低版本要加可用性判斷。2.3 兩端方案對比對比項Android (activity-alias)iOS (setAlternateIconName)最低支持版本Android 5.0iOS 10.3圖標來源打包進APK的mipmap資源打包進Bundle的png文件切換時系統(tǒng)提示無但桌面圖標會閃動有彈窗無法繞過是否需要重啟App否否圖標數(shù)量限制理論上無限制建議不超過10個審核風險無需在審核時說明用途3. Unity工程側(cè)改造讓構(gòu)建管線自動處理原生配置3.1 為什么不能手動改原生工程Unity的構(gòu)建流程是這樣的每次Build它都會重新生成Android的AndroidManifest.xml和iOS的Info.plist或者至少覆蓋你手動改的部分。你這次手動加了activity-alias下次出包就沒了。所以必須把配置注入到Unity的構(gòu)建管線里。Unity提供了兩個關(guān)鍵接口IPreprocessBuildWithReport和IPostprocessBuildWithReport。前者在構(gòu)建前執(zhí)行后者在構(gòu)建后執(zhí)行。對于Android我們需要在構(gòu)建后修改AndroidManifest.xml因為Unity生成的manifest在構(gòu)建后才最終確定對于iOS我們需要在構(gòu)建后修改Info.plist并拷貝圖標文件。3.2 Android側(cè)PostprocessBuild注入activity-aliasAndroid的manifest處理有個坑Unity構(gòu)建出來的工程AndroidManifest.xml在Temp/StagingArea目錄下構(gòu)建完成后會被拷貝到最終的Gradle工程里。我們需要在OnPostprocessBuild里找到這個文件并修改。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設置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動態(tài)圖標配置注入完成); } 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; } }這段代碼有幾個關(guān)鍵點PostProcessBuild的優(yōu)先級設為1000確保在其他后處理腳本之后執(zhí)行處理了Gradle工程和直接APK兩種構(gòu)建模式用XmlDocument操作而不是字符串替換避免格式錯誤。3.3 iOS側(cè)PostprocessBuild修改Info.plist并拷貝圖標iOS這邊更麻煩一點因為除了改Info.plist還要把圖標文件拷貝到正確的位置。Unity構(gòu)建出來的Xcode工程Info.plist在Unity-iPhone/Info.plist圖標需要拷貝到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); // 主圖標 PlistElementDict primaryIcon bundleIcons.CreateDict(CFBundlePrimaryIcon); PlistElementArray primaryFiles primaryIcon.CreateArray(CFBundleIconFiles); primaryFiles.AddString(AppIcon60x60); // 備選圖標 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); // 拷貝圖標文件到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動態(tài)圖標配置注入完成); } 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(圖標文件不存在: 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安全得多。圖標文件我放在Assets/Editor/DynamicIcons/iOS/目錄下構(gòu)建時自動拷貝。3.4 Unity與原生層的橋接Unity側(cè)要調(diào)用原生的切換方法需要做平臺判斷和橋接。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í)行圖標切換: iconName); #endif } #if UNITY_IOS !UNITY_EDITOR [System.Runtime.InteropServices.DllImport(__Internal)] private static extern void _SwitchIcon(string iconName); #endif }iOS側(cè)需要一個.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(切換圖標失敗: %, error); }]; }); } }這個.mm文件需要放在Assets/Plugins/iOS/目錄下Unity會自動把它編譯進Xcode工程。4. 實操全流程從資源準備到出包驗證4.1 圖標資源規(guī)范與準備Android和iOS對圖標尺寸的要求不一樣我整理了一個對照表平臺用途尺寸命名規(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的圖標放在Assets/Plugins/Android/res/下Unity構(gòu)建時會自動合并到APK的res目錄。注意不要放在Assets/Resources/下那樣不會被打進原生資源。iOS的圖標命名有個坑CFBundleIconFiles里寫的是AppIcon_Festival60x60系統(tǒng)會自動去找AppIcon_Festival60x60.png、AppIcon_Festival60x602x.png、AppIcon_Festival60x603x.png。所以命名必須嚴格一致大小寫敏感。4.2 構(gòu)建腳本的完整配置把上面兩個Postprocessor腳本放到Assets/Editor/目錄下Unity會自動識別。但有幾個配置項需要確認Player Settings → Publishing Settings → Build如果勾選了Custom Main ManifestUnity會用你提供的manifest而不是自動生成。這種情況下你需要手動在自定義manifest里加aliasPostprocessor腳本要相應調(diào)整。Player Settings → Other Settings → Package Name確保包名正確alias的name會基于包名生成。iOS Player Settings → Icon這里配置的是主圖標備選圖標不走這里走我們的Postprocessor。我建議的做法是不勾選Custom Main Manifest讓Unity自動生成然后Postprocessor在構(gòu)建后注入。這樣最省心。4.3 切換邏輯的時機與狀態(tài)管理圖標切換不是隨便什么時候都能調(diào)的。我的經(jīng)驗是不要在App啟動時立即切換。啟動階段系統(tǒng)資源緊張切換容易失敗。建議在進入主界面后延遲1-2秒再執(zhí)行。切換狀態(tài)要持久化。用PlayerPrefs記錄當前圖標名下次啟動時對比服務端下發(fā)的配置如果一致就不重復切換避免不必要的閃動和彈窗。切換前檢查網(wǎng)絡和資源。如果圖標資源是熱更下載的Android可以iOS不行因為圖標必須打包進Bundle要確保下載完成再切換。public class IconSwitchController : MonoBehaviour { private const string ICON_KEY current_icon_name; void Start() { Invoke(CheckAndSwitchIcon, 2f); } private void CheckAndSwitchIcon() { string serverIcon GetServerIconConfig(); // 從服務端或本地配置讀取 string localIcon PlayerPrefs.GetString(ICON_KEY, default); if (serverIcon ! localIcon) { DynamicIconManager.SwitchIcon(serverIcon); PlayerPrefs.SetString(ICON_KEY, serverIcon); PlayerPrefs.Save(); } } }4.4 出包驗證清單出包后別急著發(fā)按這個清單過一遍Android安裝后桌面圖標是否正常顯示默認圖標用adb shell dumpsys package 包名查看alias的enabled狀態(tài)是否正確。Android調(diào)用切換后桌面圖標是否變成目標圖標殺掉App重開圖標是否保持Android切換時App是否被殺掉如果被殺檢查DONT_KILL_APP標志是否傳了。iOS安裝后圖標是否正常切換時是否彈出系統(tǒng)提示切換后圖標是否變化iOS殺掉App重開圖標是否保持恢復默認圖標是否正常雙端連續(xù)切換多次是否有異常圖標資源是否都正確打包5. 常見問題與排查技巧實錄5.1 Android端典型問題問題一桌面上出現(xiàn)兩個圖標。這是最常見的問題。原因通常是主Activity的intent-filter里還保留著LAUNCHER category。檢查AndroidManifest.xml確保主Activity的intent-filter里只有MAIN action沒有LAUNCHER category。另外檢查是否有多個alias同時處于enabled狀態(tài)。問題二切換后圖標沒變但alias狀態(tài)變了。這種情況通常是launcher緩存導致的。不同廠商的launcher刷新機制不一樣小米和華為一般會立即刷新OPPO和vivo可能有延遲。解決辦法是切換后發(fā)一個廣播通知launcher刷新但這不是標準API各廠商支持情況不一。我的做法是切換后彈一個Toast提示用戶圖標將在幾秒后更新給用戶預期。問題三切換時App閃退。檢查是否在主線程調(diào)用setComponentEnabledSetting。這個API必須在主線程執(zhí)行。另外檢查alias的name是否拼寫正確ComponentName的第二個參數(shù)必須是完整類名包名alias名。問題四某些機型上alias不生效。部分定制ROM尤其是早期的EMUI和MIUI對activity-alias的支持有問題。實測下來Android 7.0以上的主流機型基本沒問題Android 5.x和6.x的部分機型可能有兼容性問題。如果目標用戶里老機型占比高建議做降級處理檢測切換是否成功失敗則提示用戶手動更換。5.2 iOS端典型問題問題一切換時報錯icon name not found。檢查三件事Info.plist里CFBundleAlternateIcons的key是否和傳入的name一致圖標文件是否在Bundle根目錄下不是Assets.xcassets文件名是否和CFBundleIconFiles里聲明的一致包括2x、3x后綴。問題二切換時彈窗提示您已更改圖標能否去掉不能。這是iOS的系統(tǒng)行為公開API無法繞過。有些團隊嘗試用UIAlertController的私有方法去攔截但在iOS 13以后已經(jīng)失效。接受它或者在產(chǎn)品層面引導用戶比如切換前先彈一個自定義提示說明會有一個系統(tǒng)彈窗。問題三審核時被拒說動態(tài)圖標功能不明確。App Store審核指南對動態(tài)圖標沒有明確禁止但如果你的App切換圖標后功能沒有變化審核員可能認為這是無意義的功能。建議在審核時提供說明動態(tài)圖標用于節(jié)日活動或用戶個性化并在App內(nèi)提供明確的切換入口。問題四iPad上不生效。iPad的圖標尺寸和iPhone不一樣CFBundleIconFiles需要額外聲明iPad的尺寸如AppIcon_Festival76x76。如果只聲明了60x60iPad上可能不生效。建議同時聲明iPhone和iPad的圖標尺寸。5.3 雙端通用問題速查表問題現(xiàn)象可能原因排查方向解決方案切換后圖標不變資源未打包檢查APK/Bundle里是否有圖標文件確認資源路徑正確切換后App重啟未傳DONT_KILL_APP檢查Android代碼加上標志iOS切換報錯plist配置錯誤檢查CFBundleAlternateIcons修正key和文件名桌面出現(xiàn)雙圖標LAUNCHER category重復檢查manifest移除主Activity的LAUNCHER切換狀態(tài)丟失未持久化檢查PlayerPrefs切換后立即Save部分機型不生效ROM兼容性查看系統(tǒng)版本做降級提示5.4 我踩過的幾個坑第一個坑是Android的alias name用了絕對路徑。一開始我寫的是com.example.game.icon_default結(jié)果在某些機型上不生效。后來改成相對路徑.icon_default讓系統(tǒng)自動拼包名問題解決。原因是絕對路徑在某些ROM上會被當成不同的組件處理。第二個坑是iOS圖標文件放進了Assets.xcassets。Xcode的Asset Catalog會把圖標編譯成Assets.carsetAlternateIconName根本找不到。必須用folder reference的方式直接放Bundle根目錄。第三個坑是Unity構(gòu)建時覆蓋了Info.plist。我一開始在Xcode里手動改了plist結(jié)果Unity重新構(gòu)建后全沒了。后來用Postprocessor腳本自動注入才徹底解決。第四個坑是切換時機太早。在Awake里調(diào)用切換Android上經(jīng)常失敗因為Activity還沒完全初始化。改成延遲2秒后調(diào)用穩(wěn)定了。6. 工程化擴展與進階玩法6.1 圖標配置表驅(qū)動硬編碼圖標名不是好做法。我建議用ScriptableObject做配置表把圖標名、資源路徑、生效時間、平臺限制都配置化。[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; } }這樣運營配置活動時只需要改配置表不需要改代碼。6.2 服務端下發(fā)與灰度圖標切換的配置最好走服務端下發(fā)這樣可以隨時調(diào)整活動時間不需要發(fā)版。服務端返回一個JSON客戶端解析后對比本地狀態(tài)決定是否切換?；叶确矫婵梢园从脩鬒D哈?；蛘咔腊鼇砜刂颇男┯脩魠⑴c。6.3 與熱更系統(tǒng)的配合Android的圖標資源可以走熱更因為alias的icon屬性可以指向下載到本地的資源實際上不行alias的icon必須是打包進APK的資源。所以Android的備選圖標也必須預先打包進APK不能熱更。這一點和iOS一樣。所以動態(tài)圖標的動態(tài)指的是切換時機動態(tài)而不是圖標資源動態(tài)。這個認知很重要很多團隊一開始以為可以熱更圖標結(jié)果發(fā)現(xiàn)不行。如果確實需要大量圖標比如用戶自定義圖標Android可以通過PackageManager的setComponentEnabledSetting配合動態(tài)生成的alias來實現(xiàn)但需要反射調(diào)用隱藏API風險較高不建議。6.4 用戶體驗優(yōu)化建議切換圖標這件事用戶感知很強但也很容易做成騷擾。我的建議是給用戶選擇權(quán)。不要強制切換在設置里提供圖標選擇入口讓用戶自己選。切換前告知。尤其是iOS系統(tǒng)彈窗會讓用戶困惑提前用自定義彈窗說明。提供恢復默認的入口。用戶換了圖標后想換回來要能方便地找到。不要頻繁切換。一天切好幾次會讓用戶覺得App不穩(wěn)定。我在實際項目里的做法是默認圖標保持不變只在重大活動時通過服務端配置切換活動結(jié)束后自動恢復。同時在設置里提供圖標樣式選項讓喜歡個性化的用戶自己選。這樣既保證了運營效果又不打擾普通用戶。最后分享一個小技巧Android端可以在切換后發(fā)一個自定義廣播Intent.ACTION_PACKAGE_CHANGED部分launcher會響應這個廣播刷新圖標能減少圖標閃動的時間。但這個廣播不是所有l(wèi)auncher都認只能算錦上添花。iOS端則可以在切換完成后用UIApplication.shared.applicationIconBadgeNumber觸發(fā)一次刷新有時候能讓圖標更快更新但效果不穩(wěn)定看系統(tǒng)版本。