탭한 푸시 라우팅하기 \
모든 푸시에는data.type 필드가 있습니다. 앱은 탭을 감지해 유형을 읽고 해당 화면을 엽니다.
app/_layout.tsx
이 중 두 유형은 이 가이드에서 다루지 않는 Journeys에서 옵니다.
reengagement는 대시보드에서 만든 재참여 Journey의 푸시에 설정됩니다. member_lapsed는 가구의 소유자와 관리자에게 보내는 푸시로, 해당 Journey가 구성원이 청소를 멈췄다고 보고하면 백엔드가 보냅니다. 이들도 다른 푸시처럼 여기서 라우팅됩니다.
액션 버튼: 탭할 수 있는 곳 늘리기 \
푸시에는 버튼을 넣을 수 있습니다. 작업 푸시에는 Start cleaning과 Snooze 1h가 있고, “하우스메이트가 청소를 마침” 푸시에는 Send kudos가 있습니다. 알림을 펼치면 버튼이 나타나며, iOS에서는 길게 누르면 됩니다.
두 개의 액션 버튼이 있는 펼친 알림.
id와 레이블이 있습니다.
supabase/functions/_shared/buttons.ts
id를 event.result.actionId로 받습니다. 알림 자체를 탭하면 actionId가 없습니다. 앱은 먼저 버튼인지 확인하고, 아니면 일반 라우팅으로 넘어갑니다.
src/lib/pushActions.ts
send_after로 다음 알림을 예약하는 함수를 호출합니다. OneSignal이 그 시간까지 메시지를 보관하므로 한 시간 동안 무언가를 계속 실행할 필요가 없습니다.
supabase/functions/snooze-reminder/index.ts
모든 버튼 탭은 커스텀 이벤트
push_action_clicked로도 기록됩니다. Journey는 버튼에 따라 직접 분기할 수 없지만, 이 이벤트를 기다렸다가 action_id 속성으로 분기할 수 있습니다.버튼을 탭하면 기본적으로 앱이 열립니다. 앱을 열지 않고 탭을 처리하려면 네이티브 코드가 필요합니다. iOS에서는 알림 카테고리, Android에서는 notification service extension입니다.
들어오는 링크 재작성하기 \
앱 밖에서 오는 링크는/clean 같은 짧은 경로를 사용합니다. Expo Router의 native intent 훅이 이동 전에 이를 앱의 실제 경로로 재작성하므로, 앱 밖의 어떤 것도 화면 구성을 알 필요가 없습니다.
app/+native-intent.tsx
일반 웹 링크로 앱 열기 \
cleaning-rota:// 같은 커스텀 스킴은 앱이 설치된 경우에만 동작하며, 많은 앱이 이를 탭할 수 있게 만들지 않습니다. iOS의 Universal Links와 Android의 App Links가 이 문제를 해결합니다. 이들은 앱이 설치되어 있으면 앱을, 그렇지 않으면 웹사이트를 여는 일반 https:// 링크입니다. 그래서 이메일, SMS, 공유 메시지의 링크에 적합합니다.
설정하려면 양쪽에 선언이 필요합니다. 앱은 자신이 속한 도메인을 선언하고, 웹사이트는 어떤 앱이 자신의 링크를 열 수 있는지 선언합니다.
1
앱에 도메인 선언하기
app.json
2
Apple 연결 파일 게시하기
/.well-known/apple-app-site-association에 HTTPS로, JSON 형식으로 호스팅하세요. 앱 ID는 Apple Team ID 뒤에 번들 식별자를 붙인 것입니다.website/.well-known/apple-app-site-association
3
Android 연결 파일 게시하기
/.well-known/assetlinks.json에 호스팅하세요. 지문은 앱의 서명 인증서에서 가져옵니다. EAS에서는 eas credentials -p android를 실행해 확인할 수 있습니다.website/.well-known/assetlinks.json
4
링크 사용하기
가구 화면은 초대 링크를 공유합니다. 링크를 탭하면 코드가 미리 입력된 상태로 가입 화면이 열립니다.
app/household.tsx
app/join-household.tsx
Clean Beans는 앱이 보여줄 수 있는 경로만 처리합니다. 홈페이지는 대상에서 제외하므로 마케팅 사이트는 계속 브라우저에서 열립니다. iOS는 앱을 설치하거나 업데이트할 때 연결 파일을 읽으므로, 빌드를 출시하기 전에 파일을 게시하세요.
딥 링크
OneSignal이 플랫폼별로 URL을 처리하는 방식.
알림 페이로드
클릭 리스너에서 사용할 수 있는 모든 필드.
액션 버튼
플랫폼 제한, 아이콘, 탭 처리.