16 KB 메모리 페이지를 지원하는 Android 기기가 출시되고 있습니다. Capacitor 플러그인(또는 그 내장 의존성 중 하나)이 준비되지 않은 경우, 특정 기능이 작동하지 않거나 앱이 일부 기기에서 충돌할 수 있습니다. 강제 시행이 시작되기 때문에 이 문제를 해결하기 위한 계획을 마련해야 합니다.
중요: 2025년 11월 1일부터, Google Play에 제출되는 모든 새로운 앱 및 기존 앱의 업데이트가 Android 15+ 기기를 대상으로 하며, 64비트 기기에서 16 KB 페이지 크기를 지원해야 합니다.
이 안내서는 간단하게 유지합니다: 문제가 되는 플러그인을 찾으십시오, 쉽게 업데이트를 확인하고, 플러그인이 유지보수가 되지 않는다면, Capgo 컨설팅 당신에게 유지보수를 위해 포크하고 유지보수하도록 요청하십시오.
16 KB 장치에서 나타나는 증상
- 일부 안드로이드폰에서 작동하지만 다른 안드로이드폰(새로운 모델이 많습니다.)에서 작동하지 않습니다.
- 특정 플러그인을 사용할 때 기능이 작동하지 않습니다(카메라, 파일, 블루투스 등).
- 디버그가 때때로 작동하지만, 릴리즈 버전은 작동하지 않습니다.
팁: 최근 플래그십 안드로이드 기기를 사용하여 문제를 재현하십시오.
Step 1 — 플러그인이 문제인지 확인하십시오
- 문제를 재현하고 사용 중인 기능을 기록하십시오.
- code에서 일시적으로 기능을 숨기거나 비활성화하십시오. 문제가 사라지면 관련 플러그인이 문제의 원인일 가능성이 있습니다.
Step 2 — 실패하는 플러그인을 찾으십시오
- 기능을 하나씩 끄거나 (또는 플러그인 호출을 주석으로 처리) 앱이 더 이상 실패하지 않으면 멈추세요.
- 앱이 다시 작동하기 시작한 직전으로 기능을 끄었던 마지막 기능은 문제가 있는 플러그인을指示합니다.
Step 3 — 빠른 해결책을 찾기 위해 확인하세요.
플러그인을 알면:
- Capacitor 패키지와 함께 플러그인과 최신 버전을 업데이트하세요.
- Android 16 KB 노트를 읽으세요.
- 유사한 보고서와 권장 버전을 포함하여 열린 이슈/토론을 확인하세요.
Step 4 — 유지보수자에게 문의하세요.
최신 버전이 여전히 깨지면:
- 짧고 명확한 이슈를 열어주세요: “Android 기기에서 16 KB 페이지 크기와 함께 기능 X가 더 이상 작동하지 않습니다.”
- Capacitor 버전, 플러그인 버전, 그리고 빠른 재현 설명을 포함하세요.
- 답변이 오기까지 조금 기다리세요 — 일부 팀은 며칠이 걸릴 수 있습니다.
Step 5 — 만약 플러그인 유지 관리가 안 되는 것처럼 보인다면
관찰해야 할 신호:
- 개월 단위로 릴리즈나 유지 관리자 답변 없이.
- Android 호환성에 대한 여전히 답이 없는 여러 개의 오픈 이슈.
선택 항목:
- 유지 관리가 활발한 대체 플러그인을 사용하여 교체하십시오.
- 또는 Capgo 컨설팅 플러그인을 fork하고 유지 관리하여 앱 호환성을 유지하십시오.
Step 6 — 정상성 확인
배송하기 전에 빠른 확인:
- 최근 Android 기기와 오래된 기기에서 기능을 테스트하십시오.
- Release 빌드 사용하여 최종 테스트를 진행하세요.
- __CAPGO_KEEP_0__ Consulting
7단계 — 결정: 업데이트, 교체, 또는 분기
- 업데이트: 최선의 경우 — 최신 플러그인/앱 버전을 설치하고 끝입니다.
- 교체: 유지보수되는 대안이 존재하는 경우 switch를 사용하세요.
- 분기: 플러그인이 움직이지 않는 경우 필요할 때 fork하고 유지보수하세요. Capgo Consulting 지원 패키지 (짧고 유용)
__CAPGO_KEEP_0__ Consulting
이것을 공유하여 도움을 받는 속도를 높여보세요 (유지보수자 또는 Capgo Consulting):
- __CAPGO_KEEP_0__ Consulting
- Capacitor 버전
- 플러그인 이름과 버전
- 영향을 받는 기기/안드로이드 버전
- 당신이 시도한 것 (업데이트, 대안 등)
- 재현 방법을 간단하게 설명
Capgo: 우리는 그것을 작동시킵니다
16 KB 기기들이 앱을 깨트리고 플러그인이 준비되지 않았다면, 우리와 이야기하세요:
- 우리는 문제가 되는 플러그인을 빠르게 식별하고 실패를 확인합니다.
- 우리는 그것을 고치고: 업데이트, 패치, 또는 포크 — 그리고 유지 관리합니다.
- 우리는 규제가 시행될 때 마지막 순간의 급급함을 피하는 데 도움을 줍니다.
우리는 실패하는 기능을 알려주고 플러그인 이름 (만약 알면)을 알려주면, 나머지 작업은 우리가 처리합니다. 서비스 페이지를 방문하세요: Capgo 컨설팅