我正在为Android创建一个应用程序。所需的应用程序功能的一部分是,用户可以选择一台特殊的打印机(我们称之为Transfer printer),它将把要打印的文档传递给运行在外部服务器上的进程。
我需要采取哪些步骤才能将自定义打印机添加到Android打印面板中的打印机列表中,可以从"溢出"菜单的"打印"选项进行访问
出于用户体验考虑,希望使用现有的Android打印面板功能,而不是例如应用程序选择器中的附加共享选项;对于用户来说,单击"共享"而不是"打印"以获得所需的功能是不直观的。
先前的研究
有一个类似的问题,自从不久前发布以来,人们对它几乎没有兴趣。询问者已经确定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>
元数据
我不清楚元数据应该在哪里指定。从打印服务页面的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) {
}
}
该服务是在BroadcastReceiver中根据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() {
}
}
主要关注点
- 这不会产生额外的打印机选项
- 文件的排列是否正确?具体来说,在res下的单独XML文档中具有
<print-service>
标记?试图将标记放置在AndroidManfiest.xml文档中的任何位置都会产生IDE错误 - 如何呼叫TransferPrintService?举个例子,假设我在Chrome中,打开Overflow菜单,然后选择Print。。。调用了哪个PrintService?我如何确保它是我的
- 我是不是走错了路
我缺少的技巧实际上是通过Android设置菜单启用打印服务。事实上,这样做并不像我希望的那样简单,因为设备制造商已经从菜单中删除了设置。它应该位于菜单的"系统"部分的"辅助功能"下。
我最终安装了谷歌的云打印应用程序,这让我可以临时访问打印服务设置(以启用云打印服务)。一到这里,我就注意到我自己的服务实际上是存在的。
为了子孙后代:为了避免每次更改打印服务设置时都卸载和重新安装Cloud Print,请使用以下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"。如果这些设置名称已经存在,并且您的打印服务没有列出,那么您将需要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命令中包含任何现有的打印服务;列出的打印服务用冒号":"分隔。
重新启动设备以将更新应用于设置数据库。