안드로이드 개발시 자동복원 기능 주의사항

자동 복원 조건

자동 복원이 정상적으로 이루어지려면 아래 조건을 만족해야 합니다.

1. 패키지명이 동일해야 함
   • 백업된 데이터는 패키지명 기준으로 저장되므로 패키지명이 다르면 복원되지 않습니다.
2. 같은 서명(Signing Key)으로 서명된 앱이어야 함
   • Google Drive의 백업 데이터는 **앱 서명 키(SHA-1 해시 값)**도 함께 저장됩니다.
   • 즉, 동일한 패키지명이더라도 다른 키로 서명된 앱을 설치하면 복원이 되지 않습니다.
   • 예를 들어, 개발 중 디버그 키(debug.keystore)로 빌드한 앱과 배포용 서명 키로 빌드한 앱은 복원되지 않을 수 있습니다.
3. Google 계정이 동일해야 함
   • 백업된 데이터는 사용자의 Google Drive에 저장되므로, 같은 Google 계정으로 로그인해야 복원됩니다.
4. 백업이 정상적으로 저장되어 있어야 함
   • 이전에 자동 백업이 활성화된 상태에서 앱 데이터가 Google Drive에 저장된 경우에만 복원이 가능합니다.
5. 백업된 데이터가 삭제되지 않아야 함
   • 사용자가 Google Drive → 백업 관리에서 해당 앱의 데이터를 삭제했다면 복원이 불가능합니다.
6. android:allowBackup="true" 설정이 되어 있어야 함
   • AndroidManifest.xml에서 android:allowBackup="false"로 설정되어 있으면 자동 백업 및 복원이 동작하지 않습니다.
7. 백업된 앱의 버전보다 낮은 버전을 설치하면 복원되지 않을 수 있음
   • android:restoreAnyVersion="true"를 명시하지 않으면 백업된 앱보다 낮은 버전을 설치할 경우 복원이 제한될 수 있습니다.