GalleryPick

There are three ways to trigger the camera immediately instead of opening the gallery:

1. Via GalleryConfig: Set .isOpenCamera(true) during configuration.
2. Via Builder modification: If you already have a GalleryConfig instance, use .getBuilder().isOpenCamera(true).build() to create a modified version.
3. Via direct method call: Use the convenience method openCamera(mActivity) on the GalleryPick instance. This is the simplest method as it does not require modifying the existing GalleryConfig.

// Method 1: In Builder
GalleryConfig galleryConfig = new GalleryConfig.Builder()
          .iHandlerCallBack(iHandlerCallBack)
          .isOpenCamera(true)
          .build();
GalleryPick.getInstance().setGalleryConfig(galleryConfig).open(mActivity);

// Method 2: Modify existing config
galleryConfig.getBuilder().isOpenCamera(true).build();
GalleryPick.getInstance().setGalleryConfig(galleryConfig).open(mActivity);

// Method 3: Direct call (Recommended for convenience)
GalleryPick.getInstance().setGalleryConfig(galleryConfig).openCamera(mActivity);

The cropping feature is available via GalleryConfig.Builder.

Important Constraints:

• Cropping only works when in single-selection mode or when opening the camera directly.
• Cropped images are stored in a crop subdirectory within the directory specified by filePath.
• The library automatically creates a .nomedia file in the crop directory to prevent cropped images from appearing in the system gallery.

To use the default 1:1 aspect ratio, use .crop(true). To specify a custom aspect ratio and dimensions, use .crop(true, ratioX, ratioY, width, height).

// Default 1:1 cropping
GalleryConfig galleryConfig = new GalleryConfig.Builder()
                .imageLoader(new GlideImageLoader())
                .iHandlerCallBack(iHandlerCallBack)
                .provider("com.yancy.gallerypickdemo.fileprovider")
                .crop(true)
                .build();

// Custom aspect ratio and dimensions
GalleryConfig galleryConfigCustom = new GalleryConfig.Builder()
                .imageLoader(new GlideImageLoader())
                .iHandlerCallBack(iHandlerCallBack)
                .provider("com.yancy.gallerypickdemo.fileprovider")
                .crop(true, 1, 1, 500, 500) // ratio 1:1, 500x500
                .build();

GalleryPick.getInstance().setGalleryConfig(galleryConfig).open(mActivity);

To support file sharing and camera functionality, you must set up a FileProvider in your AndroidManifest.xml and define paths in an XML resource file.

1. Update AndroidManifest.xml

Add a <provider> tag inside the <application> element. The android:authorities value must be unique (typically your package name + the provider name).

2. Create paths XML

Create an XML file (e.g., res/xml/filepaths.xml) to define accessible paths:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <paths>
        <external-path
            name="external"
            path="" />
        <files-path
            name="files"
            path="" />
        <cache-path
            name="cache"
            path="" />
    </paths>
</resources>

3. Link to GalleryConfig

When building your GalleryConfig, pass the exact string used in android:authorities to the .provider() method.

<provider
    android:name="android.support.v4.content.FileProvider"
    android:authorities="com.yancy.gallerypickdemo.fileprovider"
    android:exported="false"
    android:grantUriPermissions="true">
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/filepaths" />
</provider>

Implement the IHandlerCallBack interface to handle the lifecycle and results of the image selection process. This interface provides callbacks for starting, succeeding, canceling, finishing, or encountering errors.

IHandlerCallBack iHandlerCallBack = new IHandlerCallBack() {
           @Override
           public void onStart() {
               Log.i(TAG, "onStart: 开启");
           }

           @Override
           public void onSuccess(List<String> photoList) {
               Log.i(TAG, "onSuccess: 返回数据");
               for (String s : photoList) {
                   Log.i(TAG, s);
               }
           }

           @Override
           public void onCancel() {
               Log.i(TAG, "onCancel: 取消");
           }

           @Override
           public void onFinish() {
               Log.i(TAG, "onFinish: 结束");
           }

           @Override
           public void onError() {
               Log.i(TAG, "onError: 出错");
            }
};

Use GalleryConfig.Builder to customize the behavior of the image picker.

Required Fields:

• .imageLoader(ImageLoader): An implementation of the ImageLoader interface (e.g., using Glide, Picasso, or Fresco).
• .iHandlerCallBack(IHandlerCallBack): Your implementation of the result listener.
• .provider(String): The authorities string defined in your FileProvider setup.

Optional Fields (with defaults):

• .pathList(List<String>): Pre-selected image paths.
• .multiSelect(boolean): Enables multiple selection (default: false).
• .multiSelect(boolean, int): Enables multiple selection with a specific limit.
• .maxSize(int): Maximum number of items for multi-selection (default: 9).
• .crop(boolean): Enables cropping (only valid for single selection or camera mode).
• .crop(boolean, int, int, int, int): Configures crop parameters (default ratio 1:1).
• .isShowCamera(boolean): Shows/hides the camera button (default: false).
• .filePath(String): Destination path for images (default: /Gallery/Pictures).

GalleryConfig galleryConfig = new GalleryConfig.Builder()
                .imageLoader(new GlideImageLoader())    // Required
                .iHandlerCallBack(iHandlerCallBack)     // Required
                .provider("com.yancy.gallerypickdemo.fileprovider")   // Required
                .pathList(path)                         // Optional
                .multiSelect(false)                      // Optional
                .multiSelect(false, 9)                   // Optional
                .maxSize(9)                             // Optional
                .crop(false)                             // Optional
                .crop(false, 1, 1, 500, 500)             // Optional
                .isShowCamera(true)                     // Optional
                .filePath("/Gallery/Pictures")          // Optional
                .build();