如何在Android应用中指定和添加自定义打印机?

时间:2015-12-14 15:19:51

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

我正在为Android创建一个应用。所需应用程序功能的一部分是用户可以选择一个特殊的打印机(我们只称它为Transfer Transfer),它将把要打印的文件传递给在外部服务器上运行的进程。

我需要采取哪些步骤将自定义打印机添加到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意图的BroadcastReceiver中启动。

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() {
    }
}

主要关注点

  • 这不会产生额外的打印机选项。
  • 文件的安排是否正确?具体来说,在res下的单独XML文档中使用<print-service>标记?尝试将标记放在AndroidManfiest.xml文档中的任何位置会产生IDE错误。
  • 如何调用TransferPrintService?举个例子,假设我在Chrome中,打开Overflow菜单,然后选择Print ...调用哪个PrintService?我如何确定它是我的?
  • 我在这里走错了轨道吗?

1 个答案:

答案 0 :(得分:0)

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

我最终安装了Google的云打印应用程序,这使我可以暂时访问打印服务设置(以启用云打印服务)。一旦进入这里,我注意到我自己的服务实际上已存在。

对于后代:为避免每次要更改打印服务设置时取消安装和重新安装云打印,请使用以下SQLite3命令,使用adb shell或使用终端仿真器(或类似):

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

您现在应该可以访问Settings数据库并使用SQLite3命令行shell。感兴趣的设置位于安全表中,并且 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'。如果这些设置名称已经存在,并且未列出您的打印服务,那么您需要更新而不是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命令中包含任何现有的打印服务;列出的打印服务用冒号“:”分隔。

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