Chrome에서 웹 앱 매니페스트 업데이트를 처리하는 방법

PWA 아이콘, 바로가기, 색상, 기타 메타데이터를 변경하는 데 필요한 사항

Adriana Jara
François Beaufort
François Beaufort
GitHub
Pete LePage

PWA가 설치되면 브라우저는 웹 앱의 정보를 사용합니다. 앱에서 사용해야 하는 아이콘 및 이(가) 열려 있어야 합니다. 하지만 업데이트해야 하는 경우 앱 바로가기를 사용하거나 새로운 테마 색상을 사용해 보시겠어요? 변경사항이 언제 어떻게 적용되나요? 어떻게 되나요?

대부분의 경우 변경사항은 매니페스트가 업데이트된 후 PWA 실행 중

데스크톱 Chrome 업데이트

PWA가 실행되거나 브라우저 탭에서 열릴 때 Chrome은 로컬 매니페스트에 변경사항이 있는지 마지막으로 확인된 시간 매니페스트가 구성되지 않은 경우 브라우저가 마지막으로 시작된 이후 선택되어 있는지 또는 브라우저에서 Chrome에서 매니페스트에 대한 네트워크 요청을 한 다음 로컬 사본과 비교합니다

매니페스트에서 일부 속성이 변경된 경우 (아래 목록 참고) Chrome은 새 매니페스트를 대기열에 넣고 모든 창이 닫힌 후에 설치합니다. 설치되면 새 매니페스트의 모든 필드 (name, short_name, 및 icons)가 업데이트됩니다.

업데이트를 트리거하는 속성은 무엇인가요?

  • display (아래 참고)
  • scope
  • shortcuts
  • start_url
  • theme_color
  • file_handlers

display 필드가 업데이트되면 어떻게 되나요?

앱의 디스플레이 모드를 browser에서 standalone로 업데이트하면 기존 사용자는 업데이트 후 창에서 앱이 열리지 않습니다. 거기 하나는 웹 앱에 대한 두 개의 디스플레이 설정이며, 하나는 매니페스트의 컨트롤) 및 사용자가 제어하는 창/브라우저 탭 설정이 있습니다. 사용자 환경설정이 항상 적용됩니다.

매니페스트 업데이트 테스트

chrome://web-app-internals 페이지 (Chrome 85 이상에서 사용 가능) 기기에 설치된 모든 PWA에 관한 자세한 정보, 매니페스트가 마지막으로 업데이트된 시점, 매니페스트가 얼마나 자주 발생했는지 업데이트 등이 있습니다

Chrome에서 업데이트된 매니페스트를 수동으로 확인하도록 하려면 다음 중 하나를 실행하세요. 명령줄 플래그 --disable-manifest-update-throttle가 포함된 Chrome 또는 Chrome을 다시 시작하면 (about://restart 사용) 타이머가 재설정되어 Chrome이 다음에 PWA가 실행될 때 업데이트된 매니페스트를 확인합니다. 그런 다음 있습니다. PWA를 닫은 후 새 매니페스트로 업데이트해야 합니다. 속성

참조

Android용 Chrome 업데이트

PWA가 실행되면 Chrome이 로컬 매니페스트가 실행된 마지막 시간을 결정합니다. 의 변경사항을 확인했습니다. 매니페스트가 지난 24일간 확인되지 않은 경우 Chrome은 매니페스트에 대한 네트워크 요청을 예약한 다음 비교합니다

매니페스트에서 일부 속성이 변경된 경우 (아래 목록 참고) Chrome은 새 매니페스트를 대기열에 추가하고 PWA의 모든 창이 닫힌 후 기기가 전원에 연결되어 있고 Wi-Fi에 연결되어 있으면 Chrome에서 업데이트된 WebAPK를 다운로드합니다. 업데이트가 완료되면 새 매니페스트의 모든 필드는 있습니다.

업데이트를 트리거하는 속성은 무엇인가요?

  • background_color
  • display
  • orientation
  • scope
  • shortcuts
  • start_url
  • theme_color
  • web_share_target

Chrome이 서버에서 업데이트된 매니페스트를 가져올 수 없는 경우 확인 사이의 기간을 30일로 늘렸습니다.

매니페스트 업데이트 테스트

about://webapks 페이지에는 기기에 설치된 PWA로, 매니페스트가 마지막이 된 시점을 알려줄 수 있음 업데이트 빈도 등을 지정할 수 있습니다.

매니페스트 업데이트를 수동으로 예약하려면 타이머 및 로컬 매니페스트는 다음을 실행합니다.

  1. 기기를 연결하고 Wi-Fi에 연결되어 있는지 확인합니다.
  2. Android 작업 관리자를 사용하여 PWA를 종료한 후 앱 패널을 사용합니다. Android 설정에서 PWA를 강제 종료합니다.
  3. Chrome에서 about://webapks을 열고 '업데이트'를 클릭합니다. 버튼을 PWA '업데이트 상태' '대기 중'으로 변경됩니다.
  4. PWA를 실행하고 제대로 로드되는지 확인합니다.
  5. Android 작업 관리자를 사용하여 PWA를 종료한 후 앱 패널을 사용합니다. Android 설정에서 PWA를 강제 종료합니다.

PWA는 보통 몇 분 내에 업데이트되는데, 업데이트가 완료되면 '업데이트 상태' '성공'으로 변경되어야 합니다.

참조