remove-url-bar

작성

bubble wrap으로 앱을 구성했을 때, 위에 url bar가 뜨고 화면 방향이 고정이 안 됐다.

1 문제 상황

  • Bubblewrap 앱 설치 시:
    • 상단 URL 바가 표시됨
    • 화면 방향 고정 안 됨
  • APK 직접 설치 시 정상 작동
  • Play Store 배포 후 다시 문제 발생

2 원인

  • Digital Asset Links 설정 문제
  • Chrome PWA는 asset links로 앱 신뢰 여부 판단
  • 설정 없으면 URL 바 표시, 화면 고정 무시

3 해결 방법

Step 1: assetlinks.json 생성

  • 경로: https:///.well-known/assetlinks.json
  • 예시: [ { "relation": ["delegate_permission/common.handle_all_urls"], "target": { "namespace": "android_app", "package_name": "com.yourcompany.yourapp", "sha256_cert_fingerprints": ["앱 서명 SHA-256 지문"] } } ]

Step 2: APK 직접 설치

  • 정상 작동: APK 서명과 assetlinks.json SHA-256 일치

Step 3: Play Store 배포 시

  • Play Store 자동 서명 적용 → SHA-256 불일치 발생

Step 4: Play Store 서명 반영

  1. Play Console → Test and Release → App Integrity → Play App Signing Settings
  2. SHA-256 certificate fingerprint 확인
  3. assetlinks.json 업데이트
  4. 배포 후 정상 동작 (URL 바 제거, 화면 고정 적용)

4 요약

  • URL bar + 화면 고정 문제 = assetlinks.json 미설정 / SHA-256 불일치
  • APK 직접 설치: 정상
  • Play Store 배포: assetlinks.json SHA-256 업데이트 필요
  • 항상 .well-known/assetlinks.json에 패키지명 + SHA-256 반영 필수