SelectSaveImagePicker is an Android library for selecting and saving images with state preservation. This library retains the state of each image, providing a seamless user experience.
- Select multiple images with state preservation
- Customizable appearance and behavior
- Permission handling with rationale and settings redirection
- Support horizontal screen
Add the following repository to your settings.gradle.kts file:
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
repositories {
google()
mavenCentral()
maven("https://jitpack.io") // Add this
}
}Then add the dependency to your build.gradle.kts file:
dependencies {
implementation ("com.github.KeunyoungSong:SelectSaveImagePicker:version")
}- Initialize the Picker: Create an instance of
SelectSaveImagePickerwith the desired configuration.
val customPickerConfig = PickerConfig.Builder(this)
.setMaxSelection(5)
.setItemSpacing(12)
.setIndicatorNumberColorHex("#FFFFFF")
.setItemStrokeWidth(4)
.setThemeColor(ContextCompat.getColor(this, color.themeColor))
.setDescriptionText("Please select images")
.setThumbnailScale(0.8f)
.build()
val imagePicker = SelectSaveImagePicker.newInstance(customPickerConfig)
imagePicker.show(supportFragmentManager, "PICKER")- Handle Selection: Implement the
OnSelectionCompleteListenerto receive the selected images.
class MainActivity : AppCompatActivity(), SelectSaveImagePicker.OnSelectionCompleteListener {
override fun onSelectionComplete(selectedImages: List<String>) {
// Handle the selected images
selectedImages.forEach { image ->
Log.d("MainActivity", "Selected image: $image")
}
}
}You can customize the appearance and behavior of the image picker by setting various configuration options in the PickerConfig class.
The core of the library is the SelectSaveImagePicker fragment, which handles the image selection UI and state management.
class SelectSaveImagePicker : BottomSheetDialogFragment() {
private var _binding: FragmentSelectSaveImagePickerBinding? = null
private val binding get() = _binding!!
private val viewModel: SelectSaveImagePickerViewModel by activityViewModels {
ViewModelFactory(
maxSelection = config.maxSelection,
repository = ImageRepository(requireContext())
)
}
// Other implementation details...
}The PermissionRequester class handles runtime permission requests and rationale display.
class PermissionRequester(
private val fragment: Fragment,
private val permission: String
) {
private lateinit var permissionLauncher: ActivityResultLauncher<String>
var onPermissionChecked: (() -> Unit)? = null
// Other implementation details...
}The ImagePickerItemView class represents each item in the image picker grid, handling selection state and display.
class ImagePickerItemView @JvmOverloads constructor(
context: Context,
attrs: AttributeSet? = null,
defStyleAttr: Int = 0
) : ConstraintLayout(context, attrs, defStyleAttr) {
private var binding: ImagePickerItemViewBinding = ImagePickerItemViewBinding.inflate(
LayoutInflater.from(context), this, true
)
// Other implementation details...
}Contributions are welcome! Please open an issue or submit a pull request on GitHub.
This project is licensed under the MIT License.
For any inquiries, please reach out to [[email protected]].