The Android Developer Challenge is back! Submit your idea before December 2.

Mencetak dokumen HTML

Mencetak konten lebih dari sekadar foto sederhana di Android memerlukan penulisan teks dan gambar dalam dokumen cetak. Framework Android menyediakan cara menggunakan HTML untuk menulis dokumen dan mencetaknya dengan sedikit kode.

Di Android 4.4 (API level 19), class WebView telah diupdate untuk memungkinkan pencetakan konten HTML. Class ini memungkinkan Anda memuat resource HTML lokal atau mendownload halaman dari web, membuat pekerjaan cetak dan menyerahkannya ke layanan cetak Android.

Tutorial ini menunjukkan cara membuat dokumen HTML yang berisi teks dan gambar dengan cepat dan menggunakan WebView untuk mencetaknya.

Memuat dokumen HTML

Mencetak dokumen HTML dengan WebView mencakup pemuatan resource HTML atau pembuatan dokumen HTML sebagai string. Bagian ini menjelaskan cara membuat string HTML dan memuatnya ke WebView untuk dicetak.

Objek tampilan ini biasanya digunakan sebagai bagian dari tata letak aktivitas. Namun, jika aplikasi tidak menggunakan WebView, Anda dapat membuat instance class khusus untuk tujuan pencetakan. Langkah utama untuk membuat tampilan cetak khusus ini adalah:

  1. Buat WebViewClient yang memulai pekerjaan cetak setelah resource HTML dimuat.
  2. Muat resource HTML ke objek WebView.

Contoh kode berikut menunjukkan cara membuat WebViewClient sederhana dan memuat dokumen HTML yang dibuat selagi menjalankan proses:

Kotlin

    private var mWebView: WebView? = null

    private fun doWebViewPrint() {
        // Create a WebView object specifically for printing
        val webView = WebView(activity)
        webView.webViewClient = object : WebViewClient() {

            override fun shouldOverrideUrlLoading(view: WebView, request: WebResourceRequest) = false

            override fun onPageFinished(view: WebView, url: String) {
                Log.i(TAG, "page finished loading $url")
                createWebPrintJob(view)
                mWebView = null
            }
        }

        // Generate an HTML document on the fly:
        val htmlDocument =
                "<html><body><h1>Test Content</h1><p>Testing, testing, testing...</p></body></html>"
        webView.loadDataWithBaseURL(null, htmlDocument, "text/HTML", "UTF-8", null)

        // Keep a reference to WebView object until you pass the PrintDocumentAdapter
        // to the PrintManager
        mWebView = webView
    }
    

Java

    private WebView mWebView;

    private void doWebViewPrint() {
        // Create a WebView object specifically for printing
        WebView webView = new WebView(getActivity());
        webView.setWebViewClient(new WebViewClient() {

                public boolean shouldOverrideUrlLoading(WebView view, String url) {
                    return false;
                }

                @Override
                public void onPageFinished(WebView view, String url) {
                    Log.i(TAG, "page finished loading " + url);
                    createWebPrintJob(view);
                    mWebView = null;
                }
        });

        // Generate an HTML document on the fly:
        String htmlDocument = "<html><body><h1>Test Content</h1><p>Testing, " +
                "testing, testing...</p></body></html>";
        webView.loadDataWithBaseURL(null, htmlDocument, "text/HTML", "UTF-8", null);

        // Keep a reference to WebView object until you pass the PrintDocumentAdapter
        // to the PrintManager
        mWebView = webView;
    }
    

Catatan: Pastikan panggilan untuk membuat pekerjaan cetak terjadi dalam metode onPageFinished() dari WebViewClient yang telah Anda buat di bagian sebelumnya. Jika tidak ingin menunggu sampai pemuatan halaman selesai, output cetak mungkin tidak lengkap atau kosong, atau mungkin gagal total.

Catatan: Contoh kode di atas menampung instance dari objek WebView, sehingga tidak akan dibersihkan sampah memori sebelum pekerjaan cetak dibuat. Pastikan untuk melakukan hal yang sama dalam implementasi Anda sendiri. Jika tidak, proses cetak mungkin gagal.

Jika Anda ingin menyertakan gambar dalam halaman, tambahkan file grafis di direktori assets/ project Anda dan tentukan URL dasar di parameter pertama metode loadDataWithBaseURL(), seperti yang ditunjukkan dalam contoh kode berikut:

Kotlin

    webView.loadDataWithBaseURL(
            "file:///android_asset/images/",
            htmlBody,
            "text/HTML",
            "UTF-8",
            null
    )
    

Java

    webView.loadDataWithBaseURL("file:///android_asset/images/", htmlBody,
            "text/HTML", "UTF-8", null);
    

Anda juga dapat memuat halaman web untuk dicetak dengan mengganti metode loadDataWithBaseURL() dengan loadUrl() seperti yang ditunjukkan di bawah ini.

Kotlin

    webView.loadUrl("http://developer.android.com/about/index.html")
    

Java

    // Print an existing web page (remember to request INTERNET permission!):
    webView.loadUrl("http://developer.android.com/about/index.html");
    

Saat menggunakan WebView untuk membuat dokumen cetak, Anda harus mengetahui batasan-batasan berikut:

  • Anda tidak bisa menambahkan header atau footer, termasuk nomor halaman, ke dokumen.
  • Opsi pencetakan untuk dokumen HTML tidak menyertakan kemampuan untuk mencetak rentang halaman, misalnya: Mencetak halaman 2 sampai 4 dari 10 halaman dokumen HTML tidak didukung.
  • Instance WebView hanya dapat memproses satu pekerjaan cetak pada satu waktu.
  • Dokumen HTML yang berisi atribut cetak CSS, seperti properti lanskap, tidak didukung.
  • Anda tidak dapat menggunakan JavaScript dalam dokumen HTML untuk memicu pencetakan.

Catatan: Konten objek WebView yang disertakan dalam tata letak juga dapat dicetak setelah memuat dokumen.

Jika Anda ingin membuat output cetak yang lebih disesuaikan dan memiliki kontrol penuh atas gambar konten pada halaman yang dicetak, lanjutkan ke tutorial selanjutnya: Tutorial Mencetak dokumen kustom.

Setelah membuat WebView dan memuat konten HTML, aplikasi Anda hampir menyelesaikan bagian dari proses pencetakan. Langkah selanjutnya adalah mengakses PrintManager, membuat adaptor cetak, dan yang terakhir, membuat pekerjaan cetak. Contoh berikut menunjukkan cara melakukan langkah ini:

Kotlin

    private fun createWebPrintJob(webView: WebView) {

        // Get a PrintManager instance
        (activity?.getSystemService(Context.PRINT_SERVICE) as? PrintManager)?.let { printManager ->

            val jobName = "${getString(R.string.app_name)} Document"

            // Get a print adapter instance
            val printAdapter = webView.createPrintDocumentAdapter(jobName)

            // Create a print job with name and adapter instance
            printManager.print(
                    jobName,
                    printAdapter,
                    PrintAttributes.Builder().build()
            ).also { printJob ->

                // Save the job object for later status checking
                printJobs += printJob
            }
        }
    }
    

Java

    private void createWebPrintJob(WebView webView) {

        // Get a PrintManager instance
        PrintManager printManager = (PrintManager) getActivity()
                .getSystemService(Context.PRINT_SERVICE);

        String jobName = getString(R.string.app_name) + " Document";

        // Get a print adapter instance
        PrintDocumentAdapter printAdapter = webView.createPrintDocumentAdapter(jobName);

        // Create a print job with name and adapter instance
        PrintJob printJob = printManager.print(jobName, printAdapter,
                new PrintAttributes.Builder().build());

        // Save the job object for later status checking
        printJobs.add(printJob);
    }
    

Contoh ini menyimpan instance objek PrintJob untuk digunakan oleh aplikasi, yang tidak diperlukan. Aplikasi Anda dapat menggunakan objek ini untuk melacak progres pekerjaan cetak saat sedang diproses. Pendekatan ini berguna saat Anda ingin memantau status pekerjaan cetak dalam aplikasi Anda atas penyelesaian, kegagalan, atau pembatalan pengguna. Pembuatan notifikasi dalam aplikasi tidak diperlukan, karena framework cetak otomatis membuat notifikasi sistem untuk pekerjaan cetak.