# ADK Getting Started

Set up your **ADK environment** and build your **first VOS3 application.**

{% if visitor.isSet === false %}
{% columns %}
{% column %}

<h4 align="center"><strong>Please login or register to gain access to the detailed material on this page.</strong></h4>
{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a><a href="https://partner-registration.verifone.com/" class="button secondary">Register for an Account</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}

Follow these steps to prepare your host, device, and toolchain.

{% hint style="info" %}
Use an APP-DEV terminal for development.

Production devices keep security controls fully enabled.
{% endhint %}

{% stepper %}
{% step %}

### Setup The Host PC

<table data-header-hidden><thead><tr><th width="390.33203125" valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td valign="top"><p>Check host requirements and install the base tools including toolchain, packman, and SDK.</p><p></p></td><td valign="top"><img src="/spaces/IfFmiYwINerMPYjzrAC6/files/PMgdwz7rFZKLgvlKM9ui" alt="Example development environment folder structure" data-size="original"></td></tr></tbody></table>

{% if visitor.isSet === true %} <a href="/spaces/IfFmiYwINerMPYjzrAC6/pages/Ngk55pC5WIpbAmp6LTaQ" class="button primary" data-icon="gear">Developer Setup</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}
{% endstep %}

{% step %}

### Prepare a Development Device

<table data-header-hidden><thead><tr><th width="390.33203125" valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td valign="top"><p>Use an APP-DEV terminal; connect the required cables and load test keys.</p><p></p></td><td valign="top"><img src="/spaces/IfFmiYwINerMPYjzrAC6/files/mMUj5HJOt6401Cz8jNTE" alt="Development terminal cabling setup" data-size="original"></td></tr></tbody></table>

{% if visitor.isSet === true %} <a href="/spaces/IfFmiYwINerMPYjzrAC6/pages/75Bm8Zj2jKvbSQUa6UFQ" class="button primary" data-icon="plug">Preparing Development Devices</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}
{% endstep %}

{% step %}

### Build your First Application

<table data-header-hidden><thead><tr><th width="390.33203125" valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td valign="top"><p>Review the ADK libraries, compiler flags, and packaging flow for your first application.</p><p></p></td><td valign="top"><img src="/spaces/IfFmiYwINerMPYjzrAC6/files/fBtTlAqga8ju2EYZZLD3" alt="Application package structure example" data-size="original"></td></tr></tbody></table>

{% if visitor.isSet === true %} <a href="/spaces/IfFmiYwINerMPYjzrAC6/pages/U8m5N31lAN7XcQ4pFbxV" class="button primary" data-icon="code">Developing Application</a><a href="/spaces/IfFmiYwINerMPYjzrAC6/pages/Znkg58dHYRjlFSXtGu0i" class="button secondary" data-icon="box-archive">Packaging</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}
{% endstep %}

{% step %}

### Install and Debug

<table data-header-hidden><thead><tr><th width="390.33203125" valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td valign="top"><p>Transfer the package to the terminal and validate it on device.</p><p></p></td><td valign="top"><img src="/files/4sgn06BS4GdJkSmjeaW0" alt="Application launch flow through MAC" data-size="original"></td></tr></tbody></table>

{% if visitor.isSet === true %} <a href="/spaces/IfFmiYwINerMPYjzrAC6/pages/ejk6v4BqtAe0oj2Ze7Ca" class="button primary" data-icon="bug">Debugging Applications</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}
{% endstep %}

{% step %}

### ADK Programmers Guide

<table data-header-hidden><thead><tr><th width="390.33203125" valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td valign="top"><p>Use the ADK Programmers guide for in-depth documentation on ADK components, sample code, and API reference.</p><p></p></td><td valign="top"><img src="https://images.unsplash.com/photo-1517770413964-df8ca61194a6?crop=entropy&#x26;cs=srgb&#x26;fm=jpg&#x26;ixid=M3wxOTcwMjR8MHwxfHNlYXJjaHw3fHxib29rfGVufDB8fHx8MTc3NjgxMDA1MHww&#x26;ixlib=rb-4.1.0&#x26;q=85" alt="VOS3 software stack overview" data-size="original"></td></tr></tbody></table>
{% endstep %}

{% step %}
{% if visitor.isSet === true %} <a href="/spaces/IfFmiYwINerMPYjzrAC6/pages/Mj9jw8LSKOcOfKX1Mj4y" class="button primary" data-icon="book">Open the ADK 5.1 Programmers guide</a><a href="/spaces/IfFmiYwINerMPYjzrAC6/pages/ijWUJv5KChjHeeibnxQC" class="button secondary" data-icon="circle-info">Review ADK Release Notes</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}

### Further Reading

<table data-header-hidden><thead><tr><th width="390.33203125" valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td valign="top"><p>Use these references for broader platform guidance and troubleshooting support.</p><p></p></td><td valign="top"><img src="/files/O03mk3aA4wm1ESNUpsp6" alt="VOS3 software stack overview" data-size="original"></td></tr></tbody></table>

{% if visitor.isSet === true %} <a href="/spaces/IfFmiYwINerMPYjzrAC6/pages/ho3FCXFBV5odzETL1rdg" class="button primary" data-icon="book-open">VOS3 User Guide</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}
{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.verifone.com/adk-os-platform/adk-getting-started.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
