Globoke povezave

Kixo Deep Links vsako osebo usmerijo na najboljši razpoložljivi cilj. Če je aplikacija nameščena, isti znamčeni HTTPS povezava odpre pravi zaslon v aplikaciji. Sicer se lahko odpre vaše spletno mesto, App Store ali Google Play kot nadomestni cilj. Preverjeno odpiranje aplikacije izvede operacijski sistem; če povezava pristane v brskalniku, Kixo uporabi nadomestni cilj, shranjen za to povezavo.

Kako se povezava odpre

Uporabite točen znamčeni gostitelj

Gostitelj povezave Kixo pripada enemu projektu in je videti kot yourbrand.kixo.cc. Razvojni projekti lahko uporabljajo drugo končnico, ki jo upravlja Kixo. Celoten gostitelj vedno kopirajte z nadzorne plošče.

Spletno mesto in QR handoff

Web SDK samodejno prepozna prihod prek povezave Kixo. getLinkData() uporabite samo, če vaše spletno mesto v svojem usmerjevalniku potrebuje razrešeni kontekst kampanje ali parametre po meri.

const link = Kixo.getLinkData();

if (link?.params.product_id) {
  // URL values are user-controlled. Allowlist them before routing.
  router.openProduct(link.params.product_id);
}

Na mobilnem spletu ponudite »Odpri v aplikaciji«

Posredujte celoten javni URL povezave, ki ga vrne Kixo. Pasica se prikaže samo na mobilnem spletu in povezavi Kixo prepusti izbiro med nameščeno aplikacijo, trgovino ali ciljem spletnega mesta.

Kixo.showSmartBanner({
  linkId: 'YOUR_KIXO_LINK_ID',
  linkUrl: 'https://YOUR_EXACT_KIXO_HOST/link/YOUR_LINK_SLUG',
  title: 'Continue in the app',
});

Nadaljujte sejo na namizju s kodo QR

Za kodo QR na vašem spletnem mestu naj Kixo ustvari handoff za obstoječo povezavo, namesto da URL sestavite sami. Kixo uporabi cilja za aplikacijo in spletno mesto, shranjena za to povezavo.

const handoff = await Kixo.createQrHandoff({
  linkId: 'YOUR_KIXO_LINK_ID',
  params: {
    product_id: '42',
  },
});

qrCode.render(handoff.url);

Android App Links

Preden urejate kodo, v Aplikacije in nastavitev shranite ime paketa za Android in vse podpisne prstne odtise aplikacije SHA-256. Če izdajo podpisuje Google Play, dodajte še prstni odtis Play App Signing ter vse prstne odtise, uporabljene za neposredne ali interne build-e.

1. Dodajte gostitelja v manifest

Ta intent filter dodajte dejavnosti, ki upravlja navigacijo po aplikaciji. Zamenjajte samo nadomestni gostitelj.

<activity
    android:name=".MainActivity"
    android:exported="true">
    <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="YOUR_EXACT_KIXO_HOST"
            android:pathPrefix="/link/" />
    </intent-filter>
</activity>

2. Posredujte topla odpiranja

Kixo SDK pri hladnem zagonu prebere App Link. Ko Android znova uporabi obstoječo activity, posredujte njen novi intent, da bo toplo odpiranje sledilo isti poti atribucije in usmerjanja.

import android.content.Intent
import io.kixo.sdk.Kixo

override fun onNewIntent(intent: Intent) {
    super.onNewIntent(intent)
    setIntent(intent)
    intent.dataString?.let { url ->
        Kixo.handleDeepLink(url, source = "applink")
    }
}

3. Preverite Android

Po spremembi manifesta znova namestite aplikacijo, nato Androidu naročite preverjanje gostitelja in preverite rezultat.

adb shell pm verify-app-links --re-verify YOUR_ANDROID_PACKAGE
adb shell pm get-app-links YOUR_ANDROID_PACKAGE

# The exact host should be "verified".
adb shell am start -W \
  -a android.intent.action.VIEW \
  -d "https://YOUR_EXACT_KIXO_HOST/link/YOUR_LINK_SLUG"

iOS Universal Links

V Aplikacije in nastavitev shranite bundle ID aplikacije in Apple team ID. V Xcode omogočite zmožnost Associated Domains na istem cilju aplikacije in v isti konfiguraciji podpisovanja kot pri nameščenem buildu.

1. Dodajte povezano domeno

applinks:YOUR_EXACT_KIXO_HOST

2. Posredujte hladna in topla odpiranja povezav

Izberite življenjski cikel, ki ga uporablja vaša aplikacija. Oba primera razrešeni cilj posredujeta vašemu usmerjevalniku; Kixo ne nadomešča navigacije v aplikaciji.

import Kixo

WindowGroup {
    ContentView()
        .onKixoDeepLink { link in
            guard link.phase == .resolved else { return }
            router.open(link.targetPath ?? link.path)
        }
}

3. Preverite iOS

1. Iz naprave izbrišite aplikacijo, nato namestite podpisani build.
2. Odprite pravo povezavo Kixo iz aplikacije Notes, Messages ali Safari. Za edini test je ne lepite samo v naslovno vrstico Safarija.
3. Potrdite, da tap na zaprto aplikacijo odpre pričakovani zaslon.
4. Aplikacijo pustite odprto, znova tapnite povezavo in potrdite toplo odpiranje.
5. Potrdite, da se odprtje povezave prikaže v Kixo.

Usmerjanje naj ostane znotraj vaše aplikacije

Povezava Kixo lahko vsebuje cilj, na primer /products/42. Znane poti preslikajte na svoje zaslone in ohranite obstoječa preverjanja dostopa v aplikaciji. Razrešene vrednosti ne uporabite kot splošni odpiralnik URL.

Kixo.setDeferredDeepLinkListener { link ->
    if (link?.phase != KixoDeepLinkPhase.RESOLVED) return@setDeferredDeepLinkListener
    when {
        link.targetUrl?.startsWith("/products/") == true ->
            router.openProduct(link.targetUrl.substringAfterLast("/"))
        link.targetUrl == "/account" ->
            router.openAccount()
    }
}

To predajte pomočniku za programiranje

Pet nadomestnih mest zamenjajte z vrednostmi iz Nastavitve projekta → Aplikacije in nastavitev in Globoke povezave, nato celotno navodilo prilepite v Codex, Claude Code, Cursor, Windsurf ali drugega pomočnika za programiranje.

Add Kixo Deep Links to this app.

Project values:
- Kixo branded host: YOUR_EXACT_KIXO_HOST
- Android package name: YOUR_ANDROID_PACKAGE
- Android SHA-256 signing fingerprints: YOUR_ANDROID_FINGERPRINTS
- iOS bundle ID: YOUR_IOS_BUNDLE_ID
- Apple team ID: YOUR_APPLE_TEAM_ID

Requirements:
1. Use the exact branded host above. Do not replace it with kixo.cc, dixo.dev, a wildcard, or the website domain.
2. Keep the app's existing navigation. Kixo resolves and measures the link; the app decides which screen to show.
3. Android:
   - add an android:autoVerify App Links intent filter for https://YOUR_EXACT_KIXO_HOST/link/
   - keep the package name and every release signing fingerprint in Kixo Apps & setup
   - forward warm Activity.onNewIntent URLs to Kixo.handleDeepLink(url, source = "applink")
4. iOS:
   - add applinks:YOUR_EXACT_KIXO_HOST to the app target's Associated Domains entitlement
   - keep the bundle ID and Apple team ID in Kixo Apps & setup
   - for SwiftUI, attach .onKixoDeepLink to the root view
   - for UIKit scenes, forward cold connectionOptions and warm NSUserActivity callbacks to Kixo
5. Route only known in-app paths. Do not blindly open an arbitrary URL returned by a link.
6. Test a cold open and a warm open on a physical device or emulator. Confirm the app opens directly and the link open appears in Kixo.

Return:
- the files changed
- the exact host configured in each platform
- cold-open and warm-open test results
- anything still requiring a dashboard or signing-account change

Kontrolni seznam za izdajo

• Točen gostitelj Kixo je nastavljen tako v Android kot v iOS konfiguraciji.
• Android poroča, da je gostitelj preverjen za produkcijski paket.
• Podpisni prstni odtisi izdaje so shranjeni v Kixo.
• Entitlement za iOS je prisoten v podpisanem buildu aplikacije.
• Hladno in toplo odpiranje pripeljeta na pričakovani zaslon.
• Nadomestni cilj za spletno mesto ali trgovino deluje tudi brez nameščene aplikacije.
• Odprtje povezave je vidno v analitiki Kixo.

Sorodni vodiči

• Android SDK
• iOS SDK
• AI pomočniki za programiranje