frankiesardo/icepick
Icepick
Icepick is an Android instance state library and persistence tool designed to automate the serialization and restoration of object state within Android bundles. It provides a framework for maintaining application state during activity recreation, configuration changes, and process death.
The project utilizes annotation-driven code generation to create the boilerplate logic required for bundle manipulation and key management. It distinguishes itself through a provider-based serialization system that allows for custom serialization and deserialization logic when handling complex types that do not support standard bundling.
The library covers automated state restoration and bundle-key mapping to ensure consistent data retrieval. It also includes mechanisms for type-specific serialization to decouple data models from the underlying persistence logic.
Features
- Activity Bundle Restorations - Automates the restoration of application state from Android bundles after activity recycling.
- Persistent Application State - Handles bundle key creation and value manipulation to preserve application data across activity recreation.
- Ephemeral State Persistence - Saves and restores temporary UI and data states specifically before system-initiated process destruction.
- Annotation-Driven Code Generators - Generates the necessary boilerplate for bundle manipulation and key management using custom class markers at build time.
- Android Libraries - Provides a pre-written software package designed to automate state serialization and restoration in Android applications.
- Instance State Management - Saves and restores app state during configuration changes or process death to prevent data loss.
- Property-to-Key Mapping - Links internal object properties to unique string keys to ensure consistent state retrieval from Android bundles.
- Serialization Type Providers - Delegates the conversion of complex types to external provider classes to decouple serialization from data models.
- Android Bundle Type Providers - Defines custom serialization and deserialization logic for complex types that do not support standard Android bundling.
- Custom Android Bundle Serialization - Defines specific logic for how complex data types are converted into bundles for storage and retrieval on Android.
- Custom State Serialization - Allows developers to define specific controls for how certain types are serialized into stable bundles.
- Type-Specific Serialization - Applies custom bundling rules based on data types to handle non-standard object processing during state persistence.
- Android Development Utilities - Simplified management of Android instance state.
- ProGuard Configurations - Provides state restoration configuration rules.
