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.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
