FairScan Intent Sample

A minimal Android application demonstrating how to invoke FairScan using an implicit intent.

This project is meant as a simple reference or testing playground for integrating with FairScan from other apps.

What it does

• Creates an intent with the action: org.fairscan.app.action.SCAN_TO_PDF
• Launches FairScan using registerForActivityResult
• Retrieves the PDF returned by FairScan and saves it locally
• Shows a fallback message if FairScan is not installed

Useful to experiment with integration behavior and how Android resolves implicit intents.

How the intent is invoked

val launcher = registerForActivityResult(
    ActivityResultContracts.StartActivityForResult()
) { result ->
    when (result.resultCode) {
        RESULT_OK -> {
            val uri = result.data?.data ?: return@registerForActivityResult
            // Save the content of the PDF pointed by uri
         }
        RESULT_CANCELED -> { /* User cancelled the scan */ }
        else -> {}
    }
}

val scanIntent = Intent("org.fairscan.app.action.SCAN_TO_PDF")
try {
    launcher.launch(scanIntent)
} catch(_: ActivityNotFoundException) {
    // Fairscan not found: show a message to the user
}

See the code for MainActivity.

How to check availability

If you want to programmatically check from your app, whether FairScan is available to serve this intent, you can do the following:

fun isFairScanAvailable(context: Context): Boolean {
    val scanIntent = Intent("org.fairscan.app.action.SCAN_TO_PDF")
    val packageManager = context.packageManager;
    return scanIntent.resolveActivity(packageManager) != null;
}

Due to the decreased package visibility since Android 11 (API level 30), see https://developer.android.com/training/package-visibility, you also need to add the following to your AndroidManifest.xml, else the resolved Activity will always be null:

<queries>
    <intent>
        <action android:name="org.fairscan.app.action.SCAN_TO_PDF" />
    </intent>
   <!-- ... -->
</queries>