Expo 推送通知實操指南從權限到點擊回傳【免費下載鏈接】expoAn open-source framework for making universal native apps with React. Expo runs on Android, iOS, and the web.項目地址: https://gitcode.com/GitHub_Trending/ex/expoExpo 的expo-notifications庫為 React Native 應用提供跨平臺推送通知方案它封裝了 Android 的 FCM 與 iOS 的 APNs讓你用一套 API 收發(fā)通知。想給 App 加一條提醒不必自己對接推送服務裝好庫、拿到令牌就能發(fā)出第一條測試推送。環(huán)境準備npx expo install expo-notifications expo-constantsexpo-notifications負責權限、令牌和事件監(jiān)聽expo-constants負責讀取項目配置里的projectId。再在app.json的plugins數(shù)組中加入expo-notifications插件會自動寫入兩端所需的原生配置。讓最小推送跑起來權限、令牌與測試發(fā)送在拿推送令牌ExpoPushToken相當于設備在 Expo 推送服務里的唯一地址之前必須完成兩件事拿到用戶授權、找到項目projectId。倉庫里的示例 apps/notification-tester/src/registerForNotifications.ts 就是這個流程的完整實現(xiàn)核心邏輯如下import Constants from expo-constants; import { getPermissionsAsync, requestPermissionsAsync, getExpoPushTokenAsync } from expo-notifications; async function registerForPushNotificationsAsync() { let { status } await getPermissionsAsync(); if (status ! granted) { ({ status } await requestPermissionsAsync()); } if (status ! granted) { throw new Error(notification permission denied); } const projectId Constants.expoConfig?.extra?.eas?.projectId ?? Constants.easConfig?.projectId; const token (await getExpoPushTokenAsync({ projectId })).data; return token; }應用啟動后在useEffect里調用它把令牌顯示在界面上方便測試。注意令牌必須綁定projectId生成兩端配置里的 projectId 不一致會導致后續(xù)發(fā)送被拒。發(fā)送測試通知只需要向 Expo 推送服務發(fā)一個 POST 請求無需自建服務端await fetch(https://exp.host/--/api/v2/push/send, { method: POST, headers: { Content-Type: application/json }, body: JSON.stringify({ to: expoPushToken, title: Original Title, body: And here is the body!, data: { someData: goes here }, }), });data是自定義數(shù)據(jù)字段后續(xù)可以從通知對象里原樣讀回是實現(xiàn)深度鏈接的入口。生產(chǎn)環(huán)境要把令牌上傳到你自己的后端并入庫而不是只存在 App 本地。平臺差異補齊Android 渠道與 iOS 憑據(jù)Android 8.0 起通知必須掛在渠道channel通知的分類容器下不建渠道推送可能不顯示。在注冊前調用setNotificationChannelAsync創(chuàng)建默認渠道if (Platform.OS android) { await Notifications.setNotificationChannelAsync(default, { name: default, importance: Notifications.AndroidImportance.MAX, vibrationPattern: [0, 250, 250, 250], lightColor: #FF231F7C, }); }憑據(jù)兩端也各不相同Android 需要 FCM v1 憑據(jù)google-services.jsoniOS 需要 APNs 密鑰通常通過eas credentials上傳到 EAS 項目構建時自動寫入。另外兩點容易忽略Android 上令牌可能隨系統(tǒng)重啟或配置變更而更新用addPushTokenListener監(jiān)聽新令牌并回傳后端。iOS 上用戶拒絕權限彈窗后無法再發(fā)推送denied狀態(tài)要單獨處理引導用戶去系統(tǒng)設置里手動開啟。getDevicePushTokenAsync返回的是直連 FCM/APNs 的原始設備令牌走 Expo 推送服務時請用ExpoPushToken兩者不通用。前臺行為控制一個 Handler 與兩個監(jiān)聽器App 在前臺時通知默認不彈橫幅展示行為由setNotificationHandler決定Notifications.setNotificationHandler({ handleNotification: async () ({ shouldShowBanner: true, shouldShowList: true, shouldPlaySound: false, shouldSetBadge: true, }), });兩個監(jiān)聽器分工不同addNotificationReceivedListener只在前臺收到通知時觸發(fā)addNotificationResponseReceivedListener在用戶點擊通知時觸發(fā)且前后臺、冷啟動都有效const received Notifications.addNotificationReceivedListener(n { console.log(received, n.request.content.data); }); const response Notifications.addNotificationResponseReceivedListener(r { const data r.notification.request.content.data; if (data?.screen) { navigation.navigate(data.screen); } }); return () { received.remove(); response.remove(); };完整的事件對象結構和監(jiān)聽器寫法可參考文檔 docs/pages/push-notifications/receiving-notifications.mdx。批量發(fā)送與送達確認不想寫服務端代碼時可用 Expo 賬號控制臺里的 Notifications 工具直接向指定令牌發(fā)推送。接口本身支持一次提交最多 100 條消息數(shù)組只要屬于同一個項目能顯著減少請求次數(shù)。發(fā)送后服務會先返回 push ticket接收憑證真正投遞到 FCM/APNs 之后可再查 push receipt送達回執(zhí)確認結果。回執(zhí)約 15 分鐘后可用24 小時后清除。如果回執(zhí)里出現(xiàn)DeviceNotRegistered說明設備已卸載或關閉權限應停止向該令牌發(fā)送直到用戶重新注冊。?? 踩坑排錯五類常見現(xiàn)象令牌為空、注冊失敗 → 模擬器缺少 Google Play 服務 → 換物理設備或給 Android 模擬器裝上 Play 服務。發(fā)送返回 400 →to不是有效令牌或 payload 里的 projectId 與令牌不匹配 → 確認令牌由當前項目的 projectId 生成。前臺收到通知卻不彈橫幅 → handler 默認不展示 → 用setNotificationHandler顯式聲明shouldShowBanner: true。Android 通知不顯示 → 8.0 未創(chuàng)建通知渠道 → 先setNotificationChannelAsync建渠道再發(fā)推送。發(fā)送看似成功但設備收不到 → 憑據(jù)未配置或過期 → 檢查 EAS 項目里的 FCM/APNs 憑據(jù)并重新構建。收尾整條鏈路可以濃縮成三件事權限是門檻令牌是地址監(jiān)聽器是回傳。把這三件跑通后自定義聲音、角標和深度鏈接都是在此基礎上疊加。更多細節(jié)見官方文檔 docs/pages/push-notifications/庫源碼在 packages/expo-notifications/?！久赓M下載鏈接】expoAn open-source framework for making universal native apps with React. Expo runs on Android, iOS, and the web.項目地址: https://gitcode.com/GitHub_Trending/ex/expo創(chuàng)作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考 Expo 推送通知實操指南：從權限到點擊回傳
Expo 推送通知實操指南從權限到點擊回傳【免費下載鏈接】expoAn open-source framework for making universal native apps with React. Expo runs on Android, iOS, and the web.項目地址: https://gitcode.com/GitHub_Trending/ex/expoExpo 的expo-notifications庫為 React Native 應用提供跨平臺推送通知方案它封裝了 Android 的 FCM 與 iOS 的 APNs讓你用一套 API 收發(fā)通知。想給 App 加一條提醒不必自己對接推送服務裝好庫、拿到令牌就能發(fā)出第一條測試推送。環(huán)境準備npx expo install expo-notifications expo-constantsexpo-notifications負責權限、令牌和事件監(jiān)聽expo-constants負責讀取項目配置里的projectId。再在app.json的plugins數(shù)組中加入expo-notifications插件會自動寫入兩端所需的原生配置。讓最小推送跑起來權限、令牌與測試發(fā)送在拿推送令牌ExpoPushToken相當于設備在 Expo 推送服務里的唯一地址之前必須完成兩件事拿到用戶授權、找到項目projectId。倉庫里的示例 apps/notification-tester/src/registerForNotifications.ts 就是這個流程的完整實現(xiàn)核心邏輯如下import Constants from expo-constants; import { getPermissionsAsync, requestPermissionsAsync, getExpoPushTokenAsync } from expo-notifications; async function registerForPushNotificationsAsync() { let { status } await getPermissionsAsync(); if (status ! granted) { ({ status } await requestPermissionsAsync()); } if (status ! granted) { throw new Error(notification permission denied); } const projectId Constants.expoConfig?.extra?.eas?.projectId ?? Constants.easConfig?.projectId; const token (await getExpoPushTokenAsync({ projectId })).data; return token; }應用啟動后在useEffect里調用它把令牌顯示在界面上方便測試。注意令牌必須綁定projectId生成兩端配置里的 projectId 不一致會導致后續(xù)發(fā)送被拒。發(fā)送測試通知只需要向 Expo 推送服務發(fā)一個 POST 請求無需自建服務端await fetch(https://exp.host/--/api/v2/push/send, { method: POST, headers: { Content-Type: application/json }, body: JSON.stringify({ to: expoPushToken, title: Original Title, body: And here is the body!, data: { someData: goes here }, }), });data是自定義數(shù)據(jù)字段后續(xù)可以從通知對象里原樣讀回是實現(xiàn)深度鏈接的入口。生產(chǎn)環(huán)境要把令牌上傳到你自己的后端并入庫而不是只存在 App 本地。平臺差異補齊Android 渠道與 iOS 憑據(jù)Android 8.0 起通知必須掛在渠道channel通知的分類容器下不建渠道推送可能不顯示。在注冊前調用setNotificationChannelAsync創(chuàng)建默認渠道if (Platform.OS android) { await Notifications.setNotificationChannelAsync(default, { name: default, importance: Notifications.AndroidImportance.MAX, vibrationPattern: [0, 250, 250, 250], lightColor: #FF231F7C, }); }憑據(jù)兩端也各不相同Android 需要 FCM v1 憑據(jù)google-services.jsoniOS 需要 APNs 密鑰通常通過eas credentials上傳到 EAS 項目構建時自動寫入。另外兩點容易忽略Android 上令牌可能隨系統(tǒng)重啟或配置變更而更新用addPushTokenListener監(jiān)聽新令牌并回傳后端。iOS 上用戶拒絕權限彈窗后無法再發(fā)推送denied狀態(tài)要單獨處理引導用戶去系統(tǒng)設置里手動開啟。getDevicePushTokenAsync返回的是直連 FCM/APNs 的原始設備令牌走 Expo 推送服務時請用ExpoPushToken兩者不通用。前臺行為控制一個 Handler 與兩個監(jiān)聽器App 在前臺時通知默認不彈橫幅展示行為由setNotificationHandler決定Notifications.setNotificationHandler({ handleNotification: async () ({ shouldShowBanner: true, shouldShowList: true, shouldPlaySound: false, shouldSetBadge: true, }), });兩個監(jiān)聽器分工不同addNotificationReceivedListener只在前臺收到通知時觸發(fā)addNotificationResponseReceivedListener在用戶點擊通知時觸發(fā)且前后臺、冷啟動都有效const received Notifications.addNotificationReceivedListener(n { console.log(received, n.request.content.data); }); const response Notifications.addNotificationResponseReceivedListener(r { const data r.notification.request.content.data; if (data?.screen) { navigation.navigate(data.screen); } }); return () { received.remove(); response.remove(); };完整的事件對象結構和監(jiān)聽器寫法可參考文檔 docs/pages/push-notifications/receiving-notifications.mdx。批量發(fā)送與送達確認不想寫服務端代碼時可用 Expo 賬號控制臺里的 Notifications 工具直接向指定令牌發(fā)推送。接口本身支持一次提交最多 100 條消息數(shù)組只要屬于同一個項目能顯著減少請求次數(shù)。發(fā)送后服務會先返回 push ticket接收憑證真正投遞到 FCM/APNs 之后可再查 push receipt送達回執(zhí)確認結果。回執(zhí)約 15 分鐘后可用24 小時后清除。如果回執(zhí)里出現(xiàn)DeviceNotRegistered說明設備已卸載或關閉權限應停止向該令牌發(fā)送直到用戶重新注冊。?? 踩坑排錯五類常見現(xiàn)象令牌為空、注冊失敗 → 模擬器缺少 Google Play 服務 → 換物理設備或給 Android 模擬器裝上 Play 服務。發(fā)送返回 400 →to不是有效令牌或 payload 里的 projectId 與令牌不匹配 → 確認令牌由當前項目的 projectId 生成。前臺收到通知卻不彈橫幅 → handler 默認不展示 → 用setNotificationHandler顯式聲明shouldShowBanner: true。Android 通知不顯示 → 8.0 未創(chuàng)建通知渠道 → 先setNotificationChannelAsync建渠道再發(fā)推送。發(fā)送看似成功但設備收不到 → 憑據(jù)未配置或過期 → 檢查 EAS 項目里的 FCM/APNs 憑據(jù)并重新構建。收尾整條鏈路可以濃縮成三件事權限是門檻令牌是地址監(jiān)聽器是回傳。把這三件跑通后自定義聲音、角標和深度鏈接都是在此基礎上疊加。更多細節(jié)見官方文檔 docs/pages/push-notifications/庫源碼在 packages/expo-notifications/?！久赓M下載鏈接】expoAn open-source framework for making universal native apps with React. Expo runs on Android, iOS, and the web.項目地址: https://gitcode.com/GitHub_Trending/ex/expo創(chuàng)作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考