Easy Pic

An Android library that makes taking pictures from camera or gallery easy as taking a glass of water.

Installation

Add the following dependency to build.gradle:

dependencies {
    compile 'TBD'
}

Then include the node below in your app manifest:

<application
     ...>
    <provider
        android:name="dev.jameido.easypic.PicturesProvider"
        android:authorities="${applicationId}.easypicprovider"
        android:exported="false"
        android:grantUriPermissions="true"
        tools:replace="android:authorities">
        <!--easypic_picture_paths.xml is located inside easypic -->
        <meta-data
            android:name="android.support.FILE_PROVIDER_PATHS"
            android:resource="@xml/easypic_pictures_paths" />
    </provider>
    ...
</application>

Usage

Build a PickPicker instance using PicPickerBuilder:

private var mPicPicker: PicPicker = PicPickerBuilder(this)
            .showGallery()                      //Show also gallery applications in the selector
            .withModes(                         //Return the taken picture as:
                    PicPicker.BITMAP,           //Bitmap
                    PicPicker.BYTES,            //Array of bytes
                    PicPicker.FILE              //File
            )                                   //Kinda self explainatory
            .withPictureSize(400)               //Desired picture size, 0 if no resize is wanted
            .withScaleType(PicPicker.CROP)      //How the picture will be scaled to the value above
            .withSuccessListener(onPickSuccess) //See below
            .withFailureListener(onPickFailure) //See below
            .withResultListener(onPickResultListener) //Alternative to the 2 above
            .build()

To open the app selector call:

mPicPicker.openPicker()

Pick picker handles itself requesting permissions, just add:

override fun onRequestPermissionsResult(requestCode: Int, permissions: Array<out String>, grantResults: IntArray) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults)
    mPicPicker.onRequestPermissionsResult(requestCode, permissions, grantResults)
}

Pass the data got from the camera/gallery app to Pick picker with:

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)
    mPicPicker.onActivityResult(requestCode, resultCode, data)
}

Don't forget to call to avoid memory leaks:

override fun onDestroy() {
    super.onDestroy()
    mPicPicker.onDestroy()
}

Finally you want to get your images no?
There are 3 ways to get the images: as Bitmap, array of bytes or File. If you want you can get all of 3, but that's a bit overkill don't you think?

To get the image and the error pass the handlers to the builder as shown above and you can listen to the result in 2 modes, use the functions as below...

private val onPickSuccess: (result: PickerResult) -> Unit = { result ->
    //Access Picker result props and show the image
}

private val onPickFailure: (exception: Exception) -> Unit = { exception ->
    //Ops!
}

... or the plain old anonymous class way

private val onPickResultListener = object : OnPickResultListener{
    override fun onPicPickSuccess(result: PickerResult) {
        //Access Picker result props and show the image
    }

    override fun onPicPickFailure(exception: Exception) {
        //Ops!
    }
}

Using both of them won't break anything, but that's a bit overkill don't you think? (again)

Depending on the chosen mode/s the result properties will be initialized.

Customization

If you want to customize the strings proposed to the user just declare in you strings.xml file these 3:

<resources>
    ...
    <!-- Title of the camera aplpication selector panel -->
    <string name="easypic_select_picture_source">Select picture source</string>

    <!-- Shown in the snackbar when ratonale permisisons are asked -->
    <string name="easypic_permission_rationale">Camera and storage permissions are needed to take a picture.</string>

    <!-- Error shown when thre is a problem creating the result file -->
    <string name="easypic_error_creating_file">Error creating file</string>
    ...
</resources>

Demo

To get a better grasp on the functionalities see the demo ap, soon will be available in the play store.

License

MIT

Well maybe is not easy as I said before 😇