Package 

Class QMediaStoreUriLoader

  • All Implemented Interfaces:
    com.mobwith.imgmodule.load.model.ModelLoader 
    @RequiresApi(value = Build.VERSION_CODES.Q) 
public final class QMediaStoreUriLoader<DataT>
 implements ModelLoader<Uri, DataT>

    Best effort attempt to work around various Q storage states and bugs.

    In particular, HEIC images on Q cannot be decoded if they've gone through Android's exif redaction, due to a bug in the implementation that corrupts the file. To avoid the issue, we need to get at the un-redacted File. There are two ways we can do so:

    • MediaStore.setRequireOriginal
    • Querying for and opening the file via the underlying file path, rather than via {@code * ContentResolver}

    MediaStore.setRequireOriginal will only work for applications that target Q and request and currently have ACCESS_MEDIA_LOCATION. It's the simplest change to make, but it covers the fewest applications.

    Querying for the file path and opening the file directly works for applications that do not target Q and for applications that do target Q but that opt in to legacy storage mode. Other options are theoretically available for applications that do not target Q, but due to other bugs, the only consistent way to get unredacted files is via the file system.

    This class does not fix applications that target Q, do not opt in to legacy storage and that don't have ACCESS_MEDIA_LOCATION.

    Avoid using this class directly, it may be removed in any future version of ImageModule.

    • Method Detail

      • buildLoadData

         ModelLoader.LoadData<DataT> buildLoadData(@NonNull() Uri uri, int width, int height, @NonNull() Options options)

        Returns a com.mobwith.imgmodule.load.model.ModelLoader.LoadData containing a required to decode the resource represented by thismodel, as well as a set of Keys that identify the dataloaded by the com.mobwith.imgmodule.load.data.DataFetcher as well as an optional list ofalternate keys from which equivalent data can be loaded. The DataFetcher will not beused if the resource is already cached.

        Note - If no valid data fetcher can be returned (for example if a model has a null URL),then it is acceptable to return a null data fetcher from this method.

        Parameters:
        width - The width in pixels of the view or target the resource will be loaded into, orSIZE_ORIGINAL to indicate that theresource should be loaded at its original width.
        height - The height in pixels of the view or target the resource will be loaded into, orSIZE_ORIGINAL to indicate that theresource should be loaded at its original height.

      • handles

         boolean handles(@NonNull() Uri uri)

        Returns true if the given model is a of a recognized type that this loader can probably load.

        For example, you may want multiple Uri -> InputStream loaders. One might handle media storeUris, another might handle asset Uris, and a third might handle file Uris etc.

        This method is generally expected to do no I/O and complete quickly, so best effort resultsare acceptable. ModelLoaders that return true from this method may return {@code null} from buildLoadData