Simple Fragment Example

1
/*
2
 *   Copyright © 2024-2026 PSPDFKit GmbH. All rights reserved.
3
 *
4
 *   The PSPDFKit Sample applications are licensed with a modified BSD license.
5
 *   Please see License for details. This notice may not be removed from this file.
6
 */
7

8
package com.pspdfkit.catalog.examples.kotlin
9

10
import android.content.Context
11
import android.content.Intent
12
import android.net.Uri
13
import android.os.Bundle
14
import androidx.appcompat.app.AppCompatActivity
15
import com.pspdfkit.catalog.R
16
import com.pspdfkit.catalog.SdkExample
17
import com.pspdfkit.catalog.tasks.ExtractAssetTask
18
import com.pspdfkit.configuration.PdfConfiguration
19
import com.pspdfkit.configuration.activity.PdfActivityConfiguration
20
import com.pspdfkit.document.PdfDocument
21
import com.pspdfkit.listeners.DocumentListener
22
import com.pspdfkit.ui.PdfFragment
23
import com.pspdfkit.utils.getSupportParcelableExtra
24

25
/**
26
 * A very simple [PdfFragment] example with minimum configuration.
27
 * Adds a document listener to give access to the document.
28
 */
29
class SimpleFragmentExample(context: Context) : SdkExample(context, R.string.simpleFragmentExampleTitle, R.string.simpleFragmentExampleDescription) {
30
    override fun launchExample(context: Context, configuration: PdfActivityConfiguration.Builder) {
31
        ExtractAssetTask.extract(WELCOME_DOC, title, context) { documentFile ->
32
            val intent = Intent(context, SimpleFragmentActivity::class.java)
33

34
            // We pass the Uri for the PDF file that should be opened in `PdfFragment` via Intent extra.
35
            intent.putExtra(SimpleFragmentActivity.EXTRA_URI, Uri.fromFile(documentFile))
36

37
            // We pass the `PdfFragment` configuration via another extra.
38
            intent.putExtra(
39
                SimpleFragmentActivity.EXTRA_CONFIGURATION,
40
                configuration.build().configuration
41
            )
42

43
            context.startActivity(intent)
44
        }
45
    }
46
}
47

48
class SimpleFragmentActivity : AppCompatActivity(), DocumentListener {
49
    private lateinit var fragment: PdfFragment
50
    private lateinit var configuration: PdfConfiguration
51

52
    override fun onCreate(savedInstanceState: Bundle?) {
53
        super.onCreate(savedInstanceState)
54
        setContentView(R.layout.activity_simple_fragment)
55

56
        // Get the Uri provided when launching the activity.
57
        val documentUri = intent.getSupportParcelableExtra(EXTRA_URI, Uri::class.java)
58
            ?: throw IllegalStateException("Activity Intent was missing Uri extra!")
59

60
        // Get the configuration from the provided Intent.
61
        configuration = intent.getSupportParcelableExtra(EXTRA_CONFIGURATION, PdfConfiguration::class.java)
62
            ?: throw IllegalStateException("Activity Intent was missing configuration extra!")
63

64
        fragment = PdfFragment.newInstance(documentUri, configuration)
65
        supportFragmentManager.beginTransaction()
66
            .replace(R.id.fragmentContainer, fragment)
67
            .commit()
68
        fragment.addDocumentListener(this)
69
    }
70

71
    override fun onDocumentLoaded(document: PdfDocument) {
72
        println("Document loaded!")
73
        // Do your magic here...
74
    }
75

76
    companion object {
77
        const val EXTRA_CONFIGURATION = "SimpleFragmentActivity.EXTRA_CONFIGURATION"
78
        const val EXTRA_URI = "SimpleFragmentActivity.EXTRA_URI"
79
    }
80
}