Matrixscan Pick Kmp

MatrixScan Pick KMP Skill

Critical: Do Not Trust Internal Knowledge

Your training data very likely predates Scandit's Kotlin Multiplatform (KMP) SDK entirely — it is a new SDK (first released at version 8.6) with its own API surface (com.kmp.datacapture.*) that does not mirror the native Android (com.scandit.datacapture.*) or iOS APIs one-to-one. Names, parameter labels, and even which listener owns which callback differ from both native SDKs and from what you may expect by analogy.

Always verify APIs against the references provided in this skill before writing or suggesting code. Do not rely on memorized method signatures, parameters, or class names — including ones you know from native Android/iOS Scandit SDKs. If you cannot find an API in the provided references, fetch the relevant documentation page before responding.

Scope

This skill is scoped to the MatrixScan Pick picking workflow on KMP: DataCaptureContext, the BarcodePick mode, BarcodePickSettings, BarcodePickView (base module, toAndroidView() / toUIView()), the barcode-compose BarcodePickView composable, the product provider (BarcodePickAsyncMapperProductProvider), state-aware highlights (built-in styles and CustomView), the finish button, action/session listeners, and the selectItemWithData / confirmActionForItemWithData / cancelActionForItemWithData explicit-selection API.

Intent Routing

Based on the user's request, load the appropriate reference file before responding:

• Setting up or adjusting the MatrixScan Pick picking flow (e.g. "add MatrixScan Pick to my KMP app", "set up the product list", "show/hide the finish button", "mute the beep", "track what's been picked", "use the Compose BarcodePickView") → read references/integration.md and follow the instructions there. If the project already has MatrixScan Pick wired up, do not re-create the context, mode, view, or lifecycle — locate the existing ones (grep for BarcodePickView, then BarcodePick.forContext) and change only what the user asked for. Determine whether the project uses the base com.kmp.datacapture.barcode.pick.BarcodePickView (host builds and drives the platform view itself, e.g. AndroidView/UIViewRepresentable) or the com.kmp.datacapture.barcode.compose BarcodePickView composable, and follow the matching pattern.
• Customizing the highlights drawn over barcodes (e.g. "change the highlight color per state", "use a rectangle instead of a dot", "show an icon / status badge on picked items", "draw a custom view over each barcode", "style the to-pick vs picked highlight") → read references/highlights.md. This assumes the basic integration is already in place; it covers the five highlight styles and the per-state brush / icon / status-icon / custom-view APIs.

API Usage Policy

Only use APIs that are explicitly documented in the Scandit references below. Do not invent or guess class names, method signatures, or parameters — including by analogy with the native Android/iOS SDKs, which frequently differ from the KMP surface (e.g. KMP's BarcodePickSettings.soundEnabled has no is prefix, and KMP's finish-button callback is BarcodePickViewUiListener, not a UI delegate). If unsure whether an API exists or how it is called — or if a compile error occurs — fetch the relevant reference page before responding. Do not tell the user to check the docs themselves. After answering, always include the relevant link so the user can explore further.

Never construct or guess documentation URLs. When you need a specific class or property's API page:

1. First check whether the page you already fetched contains a direct hyperlink to it — topic pages link directly to relevant API symbols. Always request links alongside content in your fetch prompt.
2. If no direct link was found, fetch the API index (see Full API reference in the table below), extract the actual link from it, and follow that.

URL structures can vary and guessing will lead to 404s.

References

Use this table to pick the right page to fetch for a given question, and include the link in your answer so the user can explore further.