> For the complete documentation index, see [llms.txt](https://docs.talsec.app/freerasp/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.talsec.app/freerasp/freerasp/integration.md).

# Integration

Integrate freeRASP into your mobile app step by step, from prerequisites and SDK setup to threat callbacks, obfuscation.

The general flow of the integration can be decomposed into the following steps: 

1. Conforming to the prerequisites, e.g. setting up Android `minSdkVersion`.
2. Adding the dependency.
3. Setting up the configuration for the application, e.g. package name or whether it is production or not (see [#dev-vs.-release-version](#dev-vs.-release-version "mention")).
4. Handling the detected threats (callbacks).
5. Starting the SDK.
6. Enabling the source code obfuscation.
7. Registering in [Data Visualisation Portal](/freerasp/freerasp/data-visualisation-portal.md) to see the data from your apps and compare it to global statistics.
8. Become familiar with [User Data Policies](/freerasp/terms-of-service/user-data-policies.md) and [License](/freerasp/terms-of-service/license.md).
9. Looking at [freeMalwareDetection](broken://spaces/RJnOHq20NKRNQvVxPAdV), to provide an additional layer of protection by detecting malware or suspicious applications.
10. Looking at [Features and Pricing Plans](/freerasp/freerasp/features-and-pricing-plans.md) if you are interested in more advanced solutions to protect your application and business.
11. Reading through [Wiki](/freerasp/freerasp/wiki.md) and [FAQ](/freerasp/freerasp/faq.md), if you are interested in more detailed information about internal workings.

### Dev vs. Release version

The **Dev version** is intended for development purposes. It allows you to work on your app without interference from security features that could disrupt the process, e.g. if you would implement killing of the application on the debugger callback. 

The **Release version** is meant for production and must always be used for your published app. It enables all security protections provided by freeRASP.

To configure this, set the `isProd` flag in freeRASP:

* Release:  `isProd = true`
* Dev: `isProd = false`

**⚠️Dev** version **disables** some detections which won't be triggered during the development process:

* Emulator/Simulator
* Debugging
* Tampering/Repackaging
* Unofficial store/source
* Obfuscation issues
* Developer mode
* ADB Enabled

{% hint style="warning" %}
Make sure that you use the **Release** version for the production.
{% endhint %}

***

### Choose the Appropriate Version to Continue Integration

Choose the relevant section based on your app development platform:

<table data-view="cards"><thead><tr><th></th><th data-hidden></th><th data-hidden></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td>Android</td><td></td><td></td><td><a href="/freerasp/freerasp/integration/android.md">Android</a></td><td><a href="https://3557356308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ2PxZTOjhquOxcxftTrm%2Fuploads%2FW5TIAEE2ZVL7hpMCu6BX%2FFrame%202147223637%20(1).svg?alt=media&amp;token=d7c8c4c9-d0a9-4fad-8d39-cf7e4208a360">Frame 2147223637 (1).svg</a></td></tr><tr><td>iOS</td><td></td><td></td><td><a href="/freerasp/freerasp/integration/ios.md">iOS</a></td><td><a href="https://3557356308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ2PxZTOjhquOxcxftTrm%2Fuploads%2FH4n2pzzsGFJ8UqC1mhiy%2FFrame%202147223637%20(5).svg?alt=media&amp;token=a92a054a-c1cb-4861-b19c-4bbac8e752f2">Frame 2147223637 (5).svg</a></td></tr><tr><td>Flutter</td><td></td><td></td><td><a href="/freerasp/freerasp/integration/flutter.md">Flutter</a></td><td><a href="https://3557356308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ2PxZTOjhquOxcxftTrm%2Fuploads%2FzriaEt9NaZFpuZno2y3W%2FFrame%202147223637%20(6).svg?alt=media&amp;token=a01ecc00-51da-4eea-be79-00c054d50d97">Frame 2147223637 (6).svg</a></td></tr><tr><td>React Native</td><td></td><td></td><td><a href="/freerasp/freerasp/integration/react-native.md">React Native</a></td><td><a href="https://3557356308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ2PxZTOjhquOxcxftTrm%2Fuploads%2F5pHFWjXAIwSBmNs2Raft%2FFrame%202147223637%20(2).svg?alt=media&amp;token=990a2e9a-d9ca-4f49-ba75-ceeafd97bb60">Frame 2147223637 (2).svg</a></td></tr><tr><td>Cordova</td><td></td><td></td><td><a href="/freerasp/freerasp/integration/cordova.md">Cordova</a></td><td><a href="https://3557356308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ2PxZTOjhquOxcxftTrm%2Fuploads%2FaD8L9ZsJkIZJfuTSLkzS%2FFrame%202147223637%20(3).svg?alt=media&amp;token=3b653caa-88c7-403f-95e5-e3910bc1671e">Frame 2147223637 (3).svg</a></td></tr><tr><td>Capacitor</td><td></td><td></td><td><a href="/freerasp/freerasp/integration/capacitor.md">Capacitor</a></td><td><a href="https://3557356308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ2PxZTOjhquOxcxftTrm%2Fuploads%2FNaKWgkstUdJDTVE2xZxg%2FFrame%202147223637%20(4).svg?alt=media&amp;token=f014fd8f-ffd9-4b76-b078-1a7d72034212">Frame 2147223637 (4).svg</a></td></tr><tr><td>Kotlin Multiplatform</td><td></td><td></td><td><a href="/freerasp/freerasp/integration/kotlin-multiplatform.md">Kotlin Multiplatform</a></td><td><a href="https://3557356308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ2PxZTOjhquOxcxftTrm%2Fuploads%2FAAl5jZdEgnaxNiJLE8id%2FGroup%201%20(1).png?alt=media&amp;token=18a92efa-1a35-4486-9b06-8a2f0d02164c">Group 1 (1).png</a></td></tr><tr><td>Unity</td><td></td><td></td><td><a href="/freerasp/freerasp/integration/unity.md">Unity</a></td><td><a href="https://3557356308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ2PxZTOjhquOxcxftTrm%2Fuploads%2F3Bo3sihgejoqJo32pcXm%2FGroup%201.png?alt=media&amp;token=1be5f434-fd06-4e5e-b41d-29a406c606fc">Group 1.png</a></td></tr><tr><td>Unreal Engine</td><td></td><td></td><td><a href="/freerasp/freerasp/integration/unreal-engine.md">Unreal Engine</a></td><td><a href="https://3557356308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ2PxZTOjhquOxcxftTrm%2Fuploads%2F3Bo3sihgejoqJo32pcXm%2FGroup%201.png?alt=media&amp;token=1be5f434-fd06-4e5e-b41d-29a406c606fc">Group 1.png</a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.talsec.app/freerasp/freerasp/integration.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.