API: Deprecate CropImageContract.

[vanniktech]

No description provided.

[david-allison]

@vanniktech Is there a brief rationale/documentation on the reasons for this deprecation?

PS: Thank you for the library!

[vanniktech]

These contracts cause a lot of problems because people want to customize it, they expect different functionality, then in addition they want the Activity to be different with different feature sets, etc. Maintaining all of this becomes a mess, additionally there was the migration from the previous OnActivityResult mechanism to the new Contract API.

I want this library to evolve and support more things. The focus should be on the Image Cropping, not things that are around like the Activity & mechanism how images are loaded (Gallery/Camera/etc). Therefore I've decided to deprecate the provided Activity & the Contracts. I will keep them around and remove them with a 5.x version. The code works, so if you want to get rid of the deprecation, just copy paste the code into your application and you're done.

CropImageView is the way forward. Then everyone can decide how it should be displayed (Activity/Fragment/Compose) and what it should display (Image via Camera/Gallery/etc) and also when.