【问题标题】：How do I specify and add a custom printer in an Android app?如何在 Android 应用程序中指定和添加自定义打印机？
【发布时间】：2015-12-14 15:19:50
【问题描述】：

我正在为 Android 创建一个应用程序。所需的应用程序功能的一部分是用户可以选择一个特殊的打印机（我们称之为传输打印机），它将要打印的文档传递给在外部服务器上运行的进程。

我需要采取哪些步骤才能将自定义打印机添加到 Android 打印面板中的打印机列表（可从溢出菜单的打印选项访问）？

出于用户体验的考虑，最好使用现有的 Android 打印面板功能，而不是应用程序选择器中的附加共享选项；用户单击共享而不是打印以获得所需的功能并不直观。

先前的研究

有一个existing similar question，自从它在一段时间前发布以来就很少引起人们的兴趣。提问者已将 PrintManager 类确定为线索，但我相信 PrintService 类可能更有成果：

打印服务负责发现打印机、添加发现的打印机、删除添加的打印机以及更新添加的打印机。

同一页面详细说明打印服务的声明和配置。我已经这样做了。

尝试执行

声明与配置

在 AndroidManifest.xml 中：

...
<application
    ... >
    ...
    <service
        android:name=".TransferPrintService"
        android:permission="android.permission.BIND_PRINT_SERVICE"
        android:enabled="true"
        android:exported="false">
        <intent-filter>
            <action android:name="android.printservice.PrintService" />
        </intent-filter>
        <meta-data
            android:name="android.printservice"
            android:resource="@xml/transfer_print_service" />
    </service>
</application>

元数据

我不清楚应该在哪里指定元数据。来自 PrintService 页面的 SERVICE_META_DATA 部分：

此元数据必须引用包含打印服务标签的 XML 资源。

在 res/xml/transfer_print_service.xml 中：

<print-service
    android:label="TransferPrintService"
    android:vendor="Company Ltd." />

TransferPrintService 类

这将创建一个自定义 PrinterDiscoverySession。我现阶段的目标是让打印机出现在打印面板中并从那里开始工作。

public class TransferPrintService extends PrintService {

    public TransferPrintService() {
    }

    @Override
    public void onPrintJobQueued(PrintJob printJob) {
        printJob.start();
        printJob.complete();
    }

    @Override
    public PrinterDiscoverySession onCreatePrinterDiscoverySession() {
        return new TransferPrinterDiscoverySession(this);
    }

    @Override
    public void onRequestCancelPrintJob(PrintJob printJob) {
    }
}

服务在广播接收器中以 ACTION_BOOT_COMPLETED 意图启动。

TransferPrinterDiscoverySession 类

这实际上创建了自定义打印机。

public class TransferPrinterDiscoverySession extends PrinterDiscoverySession {
    private transferPrintService printService;
    private static final String PRINTER = "Transfer Printer";

    public transferPrinterDiscoverySession(TransferPrintService printService) {
        this.printService = printService;
    }

    @Override
    public void onStartPrinterDiscovery(List<PrinterId> printerList) {
        PrinterId id = printService.generatePrinterId(PRINTER);
        PrinterInfo.Builder builder =
                new PrinterInfo.Builder(id, PRINTER, PrinterInfo.STATUS_IDLE);
        PrinterInfo info = builder.build();
        List<PrinterInfo> infos = new ArrayList<>();
        infos.add(info);
        addPrinters(infos);
    }

    @Override
    public void onStopPrinterDiscovery() {
    }

    @Override
    public void onValidatePrinters(List<PrinterId> printerIds) {
    }

    @Override
    public void onStartPrinterStateTracking(PrinterId printerId) {
        PrinterInfo.Builder builder = new PrinterInfo.Builder(printerId,
                PRINTER, PrinterInfo.STATUS_IDLE);
        PrinterCapabilitiesInfo.Builder capBuilder =
                new PrinterCapabilitiesInfo.Builder(printerId);

        capBuilder.addMediaSize(PrintAttributes.MediaSize.ISO_A4, true);
        capBuilder.addResolution(new PrintAttributes.Resolution(
                "Default", "Default", 360, 360), true);
        capBuilder.setColorModes(PrintAttributes.COLOR_MODE_COLOR
                + PrintAttributes.COLOR_MODE_MONOCHROME,
                PrintAttributes.COLOR_MODE_COLOR);
        capBuilder.setMinMargins(PrintAttributes.Margins.NO_MARGINS);

        PrinterCapabilitiesInfo caps = capBuilder.build();
        builder.setCapabilities(caps);
        PrinterInfo info = builder.build();
        List<PrinterInfo> infos = new ArrayList<PrinterInfo>();
        infos.add(info);
        addPrinters(infos);
    }

    @Override
    public void onStopPrinterStateTracking(PrinterId printerId) {
    }

    @Override
    public void onDestroy() {
    }
}

主要问题

这不会产生额外的打印机选项。
文档排列是否正确？具体来说，将 <print-service> 标记放在 res 下的单独 XML 文档中？尝试将标记放在 AndroidManfiest.xml 文档中的任何位置都会产生 IDE 错误。
如何调用 TransferPrintService？例如，假设我在 Chrome 中，打开溢出菜单，然后选择打印...调用哪个 PrintService？如何确保它是我的？
我是不是完全走错了路？

【问题讨论】：

标签： java android xml printing android-4.4-kitkat

【解决方案1】：

我缺少的技巧实际上是通过 Android 设置菜单启用打印服务。实际上，这样做并不像我希望的那样简单，因为设备制造商已从菜单中删除了该设置。它应该在菜单系统部分的辅助功能下。

我最终安装了 Google 的云打印应用程序，这让我可以临时访问打印服务设置（以启用云打印服务）。进入这里后，我注意到我自己的服务实际上是存在的。

为了后代：为避免每次要更改打印服务设置时卸载和重新安装云打印，请使用以下 SQLite3 命令，通过 adb shell 或终端模拟器（或类似）：

sqlite3 data/data/com.android.providers.settings/databases/settings.db

您现在应该可以访问设置数据库并使用 SQLite3 命令行 shell。感兴趣的设置位于 secure 表中，分别是 enabled_print_services 和 enabled_on_first_boot_system_print_services。您可以使用以下命令检查这些设置是否已经存在：

.dump secure

如果没有，请使用以下命令：

INSERT INTO secure VALUES(<id>, 'enabled_on_first_boot_system_print_services', 'com.companyname.appservice/com.companyname.appservice.TransferPrintService');
INSERT INTO secure VALUES(<id>, 'enabled_print_services', 'com.companyname.appservice/com.companyname.appservice.TransferPrintService');

当然，您应该将“com.companyname.appservice”替换为您自己的包，并将“TransferPrintService”替换为您自己的打印服务。如果这些设置名称已经存在，并且您的打印服务未列出，那么您将需要 UPDATE 而不是 INSERT INTO：

UPDATE secure SET value = '<existing print services>:<new print service>' WHERE name = 'enabled_on_first_boot_system_print_services';
UPDATE secure SET value = '<existing print services>:<new print service>' WHERE name = 'enabled_print_services';

您需要确保在 UPDATE 命令中包含任何现有的打印服务；列出的打印服务用冒号“:”分隔。

重启设备以将更新应用到设置数据库。

【讨论】：