
在為 Unity 遊戲整合推播通知時,你可以問ChatGPT要教學 ,但說實話——它有時提供的程式碼不是過時,就是不正確。
問ChatGPT只是給個方向,細節仍然需要自行檢查、除錯並修復問題,才能讓整個流程順利運作。
在本教學中,我會教你一步步帶你完成如何使用 Firebase 無痛整合推播通知——更重要的是,如何在整合推播 SDK 與其他第三方 SDK 時,避免因為 SDK 衝突而浪費大量時間。
讓我們開始吧。
步驟 1:建立 Firebase 專案並註冊 iOS + Android 應用程式。
步驟 2:設定 Firebase 專案
設定 iOS
- 登入 Apple Developer 網站 → Certificate, Identifiers & Profiles → Keys → 建立新的 Key 並記錄 KEY ID
- 返回 Firebase 控制台 → 填入你的 KEY ID
- 你會看到如下畫面

- BundleID:<填入你的 Bundle ID>
- App Store ID:<你可以在 App Store 下載連結中找到 Store ID>
- TeamID:<填入開發者帳戶的 Team ID>
- 下載 GoogleService-Info.plist 並將其複製到 Unity 專案:Assets/ 目錄下
設定 Android
建立 SHA 憑證指紋
假設你已經建立 keystore
否則,可執行以下指令來建立 keystore:
// Format
keytool -genkey -v -keystore <keystore 路徑> -alias <別名> -keyalg RSA -keysize 2048 -validity 10000
示例:
keytool -genkey -v -keystore test-debug-key.keystore -alias test-debug -keyalg RSA -keysize 2048 -validity 10000
接著執行以下指令生成 SHA 指紋:
keytool -list -v -alias test-debug -keystore test-debug-key.keystore
- 進入 Firebase 控制台
- SHA certificate fingerprints:<填入你的 SHA 指紋>
- App nickname:<任意自訂名稱>
- Package Name:<你的 Android 套件名稱>
- 下載 google-service.json 並複製到 Unity 專案:Assets/ 目錄下

步驟 3:匯入 Firebase 套件到 Unity 專案
- 下載 Unity Firebase SDK v13.4.0
- 解壓並安裝 FirebaseAnalytics.unitypackage 與 FirebaseMessaging.unitypackage

你會在專案中看到:Assets/ExternalDependencyManager 資料夾

步驟 4:設定 Unity 的 ExternalDependencyManager
讓我們開始設定它,以確保 iOS 與 Android 都能順利安裝所有必要依賴庫。
iOS
前往 ./Assets/ExternalDependencyManager → Editor → iOS Resolver
點擊 Settings

Cocoapods Integration:<可依專案選擇 Add Cocoapods to Xcode project 或 Xcode workspace>

點擊 Reset to Defaults,然後按 OK

Android
前往 ./Assets/ExternalDependencyManager → Android Resolver → Settings

點擊 Reset to Defaults → OK

Android Resolver → 點擊 Delete Resolved Libraries 與 Force Resolve

為什麼需要重置 ExternalDependencyManager?
如果你有兩套不同的 SDK 都使用 ExternalDependencyManager,重置為預設值能協助順利解決依賴庫衝突。
這個簡單步驟能替你省下無數排錯時間。
另外,重置後建議執行 Delete Resolved Libraries 與 Force Resolve,可確保取得最新版本的依賴庫,而非舊快取。
步驟 5:整合推播通知
4.1 App 啟動時初始化 Firebase

InitializeFirebaseMessaging

定義從 FCM 接收 Device Token 的 callback

定義 OnMessageReceived 與 OnTokenReceived callback

步驟 6:測試
- Build iOS 與 Android 開始測試 App
- 確認你能在裝置日誌中看到 Registration Token
- 登入 Firebase 控制台 → Cloud Messaging → Send test message →

- 填入裝置日誌取得的 device token --> 按下 Test

你將在裝置上收到測試推播通知
總結
恭喜你已經學會如何在 Unity 中使用 Firebase 為 Android 與 iOS 設定推播通知。特別是你知道如何解決SDK相衝突的問題。
如果你覺得這篇文章對你有幫助,請按 👏 支持,或訂閱我們的電子郵件以取得最新教學。
感謝閱讀!
原文發佈於 Game Tech Tutorial











