公開資料は再現可能な実装パターンを中心にします。再配布制限のあるSDK、ファームウェア、メーカー資料は承認済み経路に限定します。
方法、バージョン、制約を伴う比較可能な根拠。
- 正確なプリンター オプション、用紙幅、サポートされている出力タイプ。
- 実際の顧客データや支払いデータを含まないテストラベルまたはレシート。
- 印刷ジョブをシリアル化できるワーカーまたはコルーチンの所有者。
公開基準
版管理された根拠とともにAndroid業務連携を構築。
公開資料は再現可能な実装パターンを中心にします。再配布制限のあるSDK、ファームウェア、メーカー資料は承認済み経路に限定します。
- 01
1 ページのモデルを構築する
明示的な幅と高さの制限を設けて、テキスト、バーコード、画像要素をページ内に保持します。クリック ハンドラー間で座標を分散させないでください。
- 02
レンダリング前にステータスを確認する
ビジー、用紙切れ、過熱、電圧不足、ドライバー エラーを個別のオペレーター状態として扱います。一般的な「印刷に失敗しました」というメッセージだけでは回復には不十分です。
- 03
シリアル化とキャンセル
作業者がプリンターを所有している間は、重複送信を無効にします。キャンセルされたジョブはリソースを閉じ、明確な再試行パスを残す必要があります。
- 04
物理的な出力を検証する
用紙幅、バーコードの読み取り可能性、送り量、コントラスト、熱挙動、バッテリーの状態を測定します。プリンターのファームウェアとアクセサリの構成を記録します。
サンプルアプリ / Kotlin
SDK・APIパターン
ポートはベンダー コールとステータス マッピングを所有します。ページ モデルは単体テストでも引き続き使用できます。
data class PrintJob(
val title: String,
val lines: List<String>,
val barcode: String?,
)
sealed interface PrintResult {
data object Printed : PrintResult
data class Blocked(val reason: String) : PrintResult
data class Failed(val reason: String) : PrintResult
}
interface PrintPort {
suspend fun print(job: PrintJob): PrintResult
}
suspend fun runPrint(port: PrintPort, job: PrintJob): PrintResult =
runCatching { port.print(job) }
.getOrElse { PrintResult.Failed("driver-error") }SDK配布
公開ゲート
ベンダーのバイナリ、APIリファレンス、ファームウェア、ソースコード例は、再配布許可と対応範囲を記録してから公開します。
ジョブをキューに入れておくか、オペレーターに再試行を依頼してください。並列ページ呼び出しを送信しないでください。
特定の回復アクションを表示し、新しいステータスになるまで待ってから再試行してください。
正確なプリンタ構成については、ページ幅、クワイエット ゾーン、モジュール サイズを確認してください。
ジョブ ポリシーに従ってキャンセルまたは終了し、ワーカーでプリンタを閉じます。
証拠ステータス
方法、バージョン、制約を伴う比較可能な根拠。
- 01
ターゲットの用紙幅でテキスト、1 つのバーコード、1 つの画像を印刷します。
- 02
操作を中断し、プリンターが解放されていることを確認します。
- 03
ビジー、用紙切れ、熱、電圧、ドライバーエラーの状態をテストします。
- 04
顧客、支払い、または認証情報のデータがログやフィクスチャに書き込まれていないことを確認します。
資料
SDK・APIパターン
ベンダーのバイナリ、APIリファレンス、ファームウェア、ソースコード例は、再配布許可と対応範囲を記録してから公開します。