16 KB 메모리 페이지가 있는 Android 디바이스가 롤아웃되고 있습니다. Capacitor 플러그인(또는 네이티브 종속 항목 중 하나)이 준비되지 않은 경우 기능이 작동하지 않거나 일부 휴대폰에서 앱이 충돌할 수 있습니다. 적용이 가속화되고 있으므로 곧 수정을 계획하십시오.
중요: 2025년 11월 1일부터 Google Play에 제출되고 Android 15 이상의 디바이스를 대상으로 하는 모든 새로운 앱 및 기존 앱의 업데이트는 64비트 디바이스에서 16 KB 페이지 크기를 지원해야 합니다.
이 가이드는 간단하게 유지합니다: 실패하는 플러그인을 찾고, 간단한 업데이트를 확인하고, 플러그인이 유지 관리되지 않는 것 같으면 Capgo Consulting에 포크 및 유지 관리를 요청하세요.
16 KB 디바이스의 증상
- 일부 Android 휴대폰에서는 작동하지만 다른 휴대폰에서는 실패합니다(종종 최신 모델).
- 특정 플러그인(카메라, 파일, Bluetooth 등)을 사용할 때 기능이 작동하지 않습니다.
- 디버그에서는 작동하지만 릴리스에서는 작동하지 않습니다.
팁: 최근 플래그십 Android 디바이스에서 시도하여 조기에 재현하십시오.
단계 1 — 플러그인 문제인지 확인하세요
- 문제를 재현하고 사용 중인 기능을 적어두세요.
- 코드에서 해당 기능을 일시적으로 숨기거나 비활성화합니다. 문제가 사라지면 관련 플러그인이 원인일 가능성이 있습니다.
단계 2 — 어느 플러그인이 실패하는지 찾으세요
- 앱이 실패하지 않을 때까지 기능을 하나씩 끕니다(또는 플러그인 호출을 주석으로 처리합니다).
- 다시 작동하기 전에 비활성화한 마지막 기능은 문제의 플러그인을 나타냅니다.
단계 3 — 빠른 수정 확인
플러그인을 알았으면:
- 플러그인의 최신 버전과 Capacitor 패키지로 업데이트합니다.
- 플러그인의 README/변경 로그에서 Android 16 KB 노트를 읽으세요.
- 유사한 보고서와 권장 버전에 대해 열린 문제/토론을 확인하세요.
단계 4 — 유지관리자에게 문의
최신 버전이 여전히 실패하는 경우:
- 짧고 명확한 이슈를 엽니다: “16 KB 페이지 크기의 Android 디바이스에서 실패합니다. 기능 X이 더 이상 작동하지 않습니다.”
- Capacitor 버전, 플러그인 버전 및 빠른 재현 설명을 포함합니다.
- 응답을 기다립니다 — 일부 팀은 며칠이 필요합니다.
단계 5 — 플러그인이 유지 관리되지 않는 경우
주의해야 할 신호:
- 몇 개월 동안 릴리스 또는 유지관리자 회신이 없습니다.
- Android 호환성에 대한 여러 개의 열린 문제가 답변이 없습니다.
귀하의 옵션:
- 활발히 유지되는 대체품으로 교체하세요.
- 또는 Capgo Consulting에 포크 및 유지 관리를 요청하여 앱이 호환성을 유지하도록 하세요.
단계 6 — 상식 확인
배송 전에 빠른 확인을 수행합니다:
- 최소한 하나의 최신 Android 디바이스와 하나의 구형 디바이스에서 기능을 테스트합니다.
- 최종 테스트를 위해 릴리스 빌드를 사용하세요.
- 통과한 앱 버전, 플러그인 버전 및 디바이스 모델의 메모를 유지하세요.
단계 7 — 결정: 업데이트, 교체 또는 포크
- 업데이트: 최선의 경우 — 최신 플러그인/앱 버전을 설치하고 완료합니다.
- 교체: 존재하는 경우 유지 관리되는 대체로 전환합니다.
- 포크: 필요하고 플러그인이 진행되지 않을 때 Capgo Consulting에 포크 및 유지 관리를 요청하세요.
지원 번들(짧고 유용함)
이것을 공유하여 도움을 가속화하세요(유지관리자 또는 Capgo Consulting과):
- 앱 버전/빌드 번호
- Capacitor 버전
- 플러그인 이름 및 버전
- 영향을 받는 디바이스/Android 버전
- 시도한 것(업데이트, 대체 등)
- 재현하는 간단한 단계
Capgo 고용: 우리가 작동하게 해드립니다
16 KB 디바이스가 앱을 깨고 플러그인이 준비되지 않은 경우 저희에게 말씀해 주세요:
- 우리는 문제 플러그인을 빠르게 식별하고 장애를 확인합니다.
- 우리가 수정합니다: 업데이트, 패치 또는 포크 — 그리고 계속 유지합니다.
- 우리는 배포가 진행되면서 마지막 순간의 서두름을 피하도록 도와줍니다.
어느 기능이 실패하는지, 플러그인 이름을 알려주세요(알고 있는 경우). 우리가 나머지를 처리합니다. 서비스 페이지를 방문하세요: Capgo Consulting
