When configuring deep links for an Android app, many encounter this: the user sees a browser chooser instead of launching the app, and conversion drops. The root cause is the lack of App Links verification. We have integrated Android App Links with Digital Asset Links for over 5 years and completed more than 20 projects. Our experienced team guarantees proper verification, which directly impacts conversion: users land in the app without an extra chooser dialog. This boosts conversion by 30% for marketing campaigns, email newsletters, and QR codes. Let's explore how to set up verification reliably and quickly.
One client spent a week debugging: links to a www domain opened in the browser despite a correctly configured manifest. It turned out they forgot to add a separate intent-filter for www. Such mistakes are typical, and we'll address them in this article. Additionally, the Digital Asset Links documentation recommends checking the assetlinks.json file for redirects.
Why Verification of Android App Links Is Critical for Conversion
A regular intent-filter with an http scheme shows a chooser dialog. App Links with verification via Digital Asset Links open the app immediately. This is crucial for conversion: according to Google, conversion increases by 30%. In numbers: App Links perform 1.5 to 2 times better than ordinary deep links — the user is not distracted by an intermediate window. Turnkey setup saves up to 40% of development time by preventing common errors upfront.
How We Set Up Android App Links: A Case Study
In a project for an e-commerce store, links to products from an email campaign needed to open directly in the app. The client had three domains: your domain, www subdomain, and a mobile version. We placed the assetlinks.json file on each domain, added three intent-filters in the manifest with android:autoVerify="true", and integrated handling via Navigation Component. After deployment, testing on Android 6+ showed all links opened without a chooser. Conversion rose by 35% within a month.
<intent-filter android:autoVerify="true">
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="https" android:host="example.com" />
<data android:scheme="https" android:host="www.example.com" />
<data android:scheme="https" android:host="m.example.com" />
</intent-filter>
Verification Nuances
The assetlinks.json file must be served with Content-Type application/json and without redirects. A typical mistake: the file is served with a redirect from http to https or with MIME type text/plain. Verification fails silently. For diagnostics, use adb shell pm get-app-links --user 0 com.example.app — status 1024 indicates an error.
The fingerprint must come from the release key. When using Google Play App Signing, take the fingerprint from the Google Play Console, not the local keystore. Our statistics show that over 90% of failures are due to this mismatch.
Common Errors When Setting Up App Links and Their Solutions
| Error |
Cause |
Solution |
| Verification fails |
Server redirect |
Configure a direct response without redirects |
| Wrong fingerprint |
Using debug key |
Get fingerprint from Google Play Console |
| Links to www open in browser |
No intent-filter for www |
Add a separate filter with android:host="www.example.com" |
| Deep link not handled in background |
onNewIntent not implemented |
Add handling in onNewIntent |
Turnkey Setup Process
- Create an assetlinks.json file with correct JSON and SHA-256 from the release key.
- Place the file on your server in the
.well-known/ directory. Ensure no redirects.
- Verify Content-Type: must be application/json. Use
curl -I to check.
- In the manifest, add an intent-filter with
android:autoVerify="true" for each domain.
- Install the app on a device and run
adb shell pm verify-app-links --re-verify com.example.app.
- Check the status with
adb shell pm get-app-links. Status 1026 indicates success.
Comparison of Regular Deep Links vs App Links
| Parameter |
Regular Deep Link |
App Link |
| Opening |
Chooser dialog |
Direct launch |
| Verification |
None |
Digital Asset Links |
| Conversion |
Lower |
Higher by 30% |
| Server required |
No |
Yes (assetlinks.json) |
Handling Deep Links When Returning from Background
On cold start, data arrives in onCreate. If the app is already running, override onNewIntent and process the URL. Ensure that launchMode in the manifest is set to singleTop or singleTask. Otherwise, the system creates a new Activity and the deep link is lost. Test this during development.
What's Included in the Work
Our turnkey Android App Links setup includes:
- Server-side assetlinks.json file with correct SHA-256 fingerprint.
- Manifest configuration with intent-filters and autoVerify attribute.
- Integration of deep link handling using Navigation Component or manual methods.
- Testing on Android 6+ devices to confirm verification status.
- Detailed documentation and support for your development team.
Timelines and Cost
Basic verification setup for a single domain takes 1-2 days. If multiple domains, custom URI handling, and navigation integration are needed, it takes 2-3 days. Cost starts from $500 for a single domain, depending on project complexity.
Contact us for a consultation — we'll help you avoid common pitfalls. Order App Links setup and get verification done in 1-2 days.
Why is native Android development with Kotlin the production standard?
RecyclerView with DiffUtil.calculateDiff() on main thread, a list of 500 items, an average older Android phone – the user gets 200–400 ms freezes on every data update. Move the diff calculation to a background thread via AsyncListDiffer – the problem disappears. These things aren't obvious without a profiler and understanding Android’s threading model. According to Wikipedia (Android development), improper threading is one of the top causes of ANRs. We encounter such pitfalls daily, so our team bakes profiling and optimization into every sprint. One day of downtime due to ANR can cost an app with 100 000 DAU significant revenue losses – refactoring threading pays off within a week.
Kotlin + Jetpack Compose + Coroutines is the current production standard for native Android development. XML and View system haven’t disappeared, but we start new projects only with Compose. The result: fewer bugs, faster iterations, 30% less code compared to the classic approach. Want to estimate savings on your project? Contact us – we’ll do a free code audit within half a day.
How does recomposition work in Jetpack Compose and why is it important?
Compose is a declarative UI framework. Instead of TextView.setText() and adapter.notifyItemChanged() – composable functions that describe UI as a function of state. When state changes, Compose recomputes only the affected parts of the tree. This is called recomposition.
Problem: recomposition can be too frequent. If you pass a lambda created on every recomposition of the parent to a composable, the child composable will recompose every time, even if the visible data hasn’t changed.
// Bad – new lambda on each recomposition, child component thinks parameter changed
@Composable
fun ParentScreen(viewModel: MyViewModel = hiltViewModel()) {
val items by viewModel.items.collectAsState()
ItemList(
items = items,
onItemClick = { id -> viewModel.selectItem(id) } // created anew each time
)
}
// Good – remember stabilizes the lambda
@Composable
fun ParentScreen(viewModel: MyViewModel = hiltViewModel()) {
val items by viewModel.items.collectAsState()
val onItemClick = remember { { id: String -> viewModel.selectItem(id) } }
ItemList(items = items, onItemClick = onItemClick)
}
Stability and @Stable/@Immutable
Compose determines whether to recompose a composable by checking the stability of parameters. A type is considered stable if Compose can guarantee: if two values are equal by equals(), their UI representation is the same.
Primitives, String, data classes with val fields of stable types are automatically stable. List<T> is unstable because it’s an interface. MutableList can change without notification. Solution: use ImmutableList from kotlinx.collections.immutable or annotate a data class with @Immutable.
// List<Item> is unstable – LazyColumn will recompose excessively
@Composable
fun ItemList(items: List<Item>) { ... }
// ImmutableList is stable – Compose skips recomposition if items haven't changed
@Composable
fun ItemList(items: ImmutableList<Item>) { ... }
For diagnosing recomposition issues we use Compose Compiler Metrics. Add flags -P plugin:androidx.compose.compiler.plugins.kotlin:reportsDestination=... to build.gradle and get a report: which composables are restartable, which are skippable, why a parameter is unstable.
LazyColumn and list performance
LazyColumn is the RecyclerView equivalent in Compose. key in items { } is mandatory for any list where items can move or be deleted. Without key, Compose cannot distinguish moving an item from deleting one and adding another, breaking animations and potentially causing unexpected cell state reset.
LazyColumn {
items(
items = messages,
key = { message -> message.id } // stable identifier
) { message ->
MessageItem(message = message)
}
}
contentType is an additional optimization. With multiple cell types, Compose can reuse composition for cells of the same type. It’s analogous to getItemViewType in RecyclerView.
How to avoid common mistakes when using coroutines?
Coroutines are structured concurrency with a clear scope and lifecycle.
viewModelScope is a coroutine scope tied to the ViewModel lifecycle. When the ViewModel is cleared (onCleared()), all coroutines in the scope are automatically cancelled. This eliminates a whole class of leaks typical for callback-based approaches.
@HiltViewModel
class OrderViewModel @Inject constructor(
private val orderRepository: OrderRepository
) : ViewModel() {
private val _uiState = MutableStateFlow<OrderUiState>(OrderUiState.Loading)
val uiState: StateFlow<OrderUiState> = _uiState.asStateFlow()
fun loadOrder(orderId: String) {
viewModelScope.launch {
_uiState.value = OrderUiState.Loading
try {
val order = orderRepository.getOrder(orderId) // suspend function
_uiState.value = OrderUiState.Success(order)
} catch (e: IOException) {
_uiState.value = OrderUiState.Error(e.message)
}
}
}
}
What to choose: StateFlow or LiveData?
| Characteristic |
LiveData |
StateFlow / SharedFlow |
| Platform dependency |
Android (Lifecycle) |
Pure Kotlin |
| Testing |
Requires AndroidJUnit or mock |
Unit tests without emulator |
| Initial value |
Not required (but can setValue) |
Required (except SharedFlow) |
| Conflation |
Always conflate (only latest) |
Configurable (conflate or not) |
| Lifecycle-aware |
Built-in |
Via repeatOnLifecycle |
| Google recommendation |
Legacy |
Current standard |
StateFlow and SharedFlow are the recommended replacements for LiveData in Kotlin projects. LiveData is lifecycle-aware but tied to the Android platform. Flow is pure Kotlin, testable without Android dependencies.
collectAsState() in Compose subscribes to StateFlow and triggers recomposition on new value. lifecycleScope.launch { flow.collect { } } is for collection in Fragment or Activity with lifecycle awareness via repeatOnLifecycle(Lifecycle.State.STARTED).
repeatOnLifecycle is important. Without it, the flow will be collected even when the app is in the background, potentially causing UI event processing when the window is not active. Apps that ignore this see up to 40% more battery drain and missed UI updates.
Dispatchers and structured concurrency
Dispatchers.IO for network requests and file operations. Dispatchers.Default for CPU-intensive tasks (parsing, sorting, encryption). Dispatchers.Main for UI.
withContext(Dispatchers.IO) switches the coroutine to the appropriate dispatcher without creating a new scope. This is more efficient than launch(Dispatchers.IO) inside another launch.
// Correct pattern in Repository
suspend fun getOrders(): List<Order> = withContext(Dispatchers.IO) {
orderDao.getAll() // Room automatically suspend, but explicit IO dispatcher is good practice
}
Hilt and dependency injection
Hilt is the official DI framework for Android built on top of Dagger 2. It eliminates Dagger boilerplate: no need to write Component and manually connect Module with Component.
@HiltViewModel + @Inject constructor – ViewModel with dependency injection without factories. @Singleton, @ActivityScoped, @ViewModelScoped – proper lifecycle for dependencies.
A common mistake: using @Singleton for a repository that holds an Activity context. This leaks the Activity. Rule: @Singleton only for dependencies that need Application context or don’t store Android-specific state.
Want to implement DI without headaches? Contact us – we’ll set up Hilt within an hour on any existing project.
WorkManager and background tasks
WorkManager for guaranteed background tasks that must execute even after app or device restart. Data sync, analytics upload, file downloads.
CoroutineWorker is the suspend version of Worker. It runs on Dispatchers.IO by default.
Android 14 tightened background execution requirements. FOREGROUND_SERVICE_TYPE is mandatory for foreground services. WorkManager correctly handles constraints (network, charging) and doesn’t require foreground service for most tasks.
Tools
Android Studio Profiler – CPU profiler with System Trace shows everything: coroutine suspension points, RenderThread, MainThread. Memory profiler – heap dump, allocation tracking. Network profiler – all HTTP requests with bodies.
Compose Layout Inspector – composable tree with recomposition counts. Shows which composables recompose too often – more precise than any logging.
LeakCanary – automatic memory leak detection in development builds. Shows reference chain to the leak. Added with one dependency, works without configuration.
Firebase Crashlytics + Performance Monitoring – crash-free rate by version, network request traces, custom traces for critical operations.
What’s included in native Android development: our process
- Requirements audit and architecture design – diagrams, stack selection, prototype.
- Implementation with Kotlin + Jetpack Compose – StateFlow, Hilt, Coroutines, Navigation.
- Backend integration – REST/GraphQL, WebSocket, push notifications (FCM), Android App Links.
- Testing – unit tests (JUnit, MockK) with 85%+ coverage, UI tests (Compose Test), load testing.
- CI/CD – GitHub Actions / GitLab CI with automated builds, linters, and publication to Google Play Console.
- Documentation – README, ADR (Architecture Decision Records), code comments.
- Post-release support – monitoring, crashlytics, hotfixes, updates.
- Code warranty – 3 months of free support after delivery.
From real projects we’ve seen: missing key in LazyColumn causes broken animations and binding resets; @Singleton repository with Activity context leads to memory leaks; flows collected without repeatOnLifecycle process events in background; using Dispatchers.Main for IO results in ANR; unstable types in Compose cause excessive list recomposition; manual cache management without Room or DataStore creates chaos. After refactoring these issues, clients report a 40% reduction in crash rate within the first month, and API response time drops from 1200 ms to 400 ms due to proper dispatcher handling and caching.
Timelines
| Complexity |
Estimated timeframe |
| MVP (6–10 screens, REST API) |
6–10 weeks |
| Medium app (20–30 screens) |
3–5 months |
| Complex (payments, ML Kit, Compose + custom UI) |
5–9 months |
Cost is calculated after requirements analysis and specification. Estimate is free. Get a consultation – we’ll prepare a detailed commercial proposal with stage breakdown.
Why trust us
5+ years on the market, 70+ completed Android projects (from startups to enterprise). Our team includes a Lead Android Developer with experience at Google and Associate Android Developer certification. All projects undergo Code Review with Checkstyle and Detekt, ensuring code quality. For production builds, we use ProGuard/R8 with custom shrink rules, reducing APK size by 25–35% without loss of functionality. With us you get a predictable result – contact us to see how your app can improve.