What is the BlackBerry Dynamics SDK migration toolkit?

You can use the BlackBerry Dynamics SDK migration toolkit to accelerate and structure the conversion of a native Android app to a BlackBerry Dynamics app that leverages the advanced security features of the BlackBerry Dynamics SDK. The migration toolkit allows you to use any AI coding agent, such as Cursor, Kiro, or Codex, to support the structured migration to BlackBerry Dynamics using a series of preconfigured prompts, steering files (constraints and API catalogs), and deterministic validation scripts. The toolkit gives you guidance and visibility at every stage of the process.

Note: The BlackBerry Dynamics SDK migration toolkit uses AI-assisted workflows to generate suggested outputs (code changes, configurations, and guidance). These outputs are assistive only, may be incomplete or inaccurate, and are not production-ready. Developers are responsible for reviewing and validating all outputs.

The migration toolkit does not modify your project itself; instead, it gives your AI coding agent precise instructions and guardrails for how to modify the app. All code changes that are proposed by the agent are minimal, reviewable, and tagged with an inline [BB_DYNAMICS-MIGRATION] comment that you can audit. You can accept, reject, or question code changes at every stage. As with any app development process, you are responsible for reviewing the conversion process and outcomes and completing any manual follow-up actions that may be required; this is especially important with complex apps that use Room, CameraX, multi-process architectures, WebView-heavy flows, or custom encryption.

When copied into your project root, the toolkit (dynamics-migration-tool) contains the following:
  • tooling: Contains entry, bootstrap, and validation scripts.
  • prompts: Contains preconfigured prompts that are run in a specific order to execute the migration process.
  • steering: Contains steering constraints.
  • output: Will contain artifacts that are generated by the migration process (for example, bootstrap.json and migration reports).
  • migration-report-viewer.html: Visual report you can use to view migration results.