Android Room: Migrate a Schema Safely
An app update changes a local table and older installations still contain valuable data. This guide gives you a small, testable way to approach the issue before changing a live system.
A practical workflow
- Export Room schemas and write a migration from the old version to the new one.
- Test the migration against a database created by an older app version.
What to check
A destructive fallback deletes local data; use it only when that loss is explicitly acceptable. Compare the result with the original problem and record what changed. If a measurement or test does not support the change, revisit the assumption rather than adding more complexity.
Keep the experiment small enough to reverse. Document the starting state, the change and the result so another person can repeat the process. Product menus and versions can change, so check the current documentation for your environment.
Official reference: Read the documentation.