diff options
author | Svetoslav Ganov <svetoslavganov@google.com> | 2013-08-11 12:29:39 -0700 |
---|---|---|
committer | Svetoslav Ganov <svetoslavganov@google.com> | 2013-08-11 14:40:05 -0700 |
commit | 798bed6cc7d273e72b0253288605db9cd2b57740 (patch) | |
tree | b4278847c40cf910b69773c6205395ada02543ed /core/java/android/printservice/package.html | |
parent | 5893a97cbf398ca3e1bff5444454343d94e25a4c (diff) | |
download | frameworks_base-798bed6cc7d273e72b0253288605db9cd2b57740.zip frameworks_base-798bed6cc7d273e72b0253288605db9cd2b57740.tar.gz frameworks_base-798bed6cc7d273e72b0253288605db9cd2b57740.tar.bz2 |
Refinement of the print service APIs.
1. Factored out the printer discovery APIs of a print service in a
dedicated session object that is created by the print service on
demand. This ensures that added/removed/updated printers from
one session do not interfere with another session.
2. Updated the app facing APIs to pass in a document info along
with a printed file. Also exposed the print file adapter so
apps that create a temporary file for printing can intercept
when it is read by the system so the file can be deleted.
3. Updated the print service documentation.
Change-Id: I3473d586c26d8bda1cf7e2bdacb441aa9df982ed
Diffstat (limited to 'core/java/android/printservice/package.html')
-rw-r--r-- | core/java/android/printservice/package.html | 24 |
1 files changed, 24 insertions, 0 deletions
diff --git a/core/java/android/printservice/package.html b/core/java/android/printservice/package.html new file mode 100644 index 0000000..6b0327c --- /dev/null +++ b/core/java/android/printservice/package.html @@ -0,0 +1,24 @@ +<HTML> +<BODY> +<p> +Provides classes for implementing print services. Print services are plug-in components +that know how to talk to printers via some standard protocols. These services serve as a +bridge between the system and the printers. Hence, the printer and print protocol specific +implementation is factored out of the system and can by independently developed and updated. +</p> +<p> +A print service implementation should extend {@link android.printservice.PrintService} +and implement its abstract methods. Also the print service has to follow the contract for +managing print {@link android.printservice.PrintJob}s to ensure correct interaction with +the system and consistent user experience. +<p/> +<p> +The system is responsible for starting and stopping a print service depending on whether +there are active print jobs for the printers managed by the service. The print service +should also perform printer discovery in a timely fashion to ensure good user experience. +The interaction between the system and the print service during printer discovery is +encapsulated by a {@link android.printservice.PrinterDiscoverySession} instance created +by the print service when requested by the system. +</p> +</BODY> +</HTML> |