Naisc dhomhain

Seolann Kixo Deep Links gach duine chuig an gceann scríbe is fearr atá ar fáil. Má tá an aip suiteáilte, osclaíonn an nasc brandáilte HTTPS céanna an scáileán ceart san aip. Mura bhfuil, is féidir leis do shuíomh gréasáin, an App Store, nó cúltaca Google Play a oscailt. Láimhseálann an córas oibriúcháin oscailt fhíoraithe na haipe; nuair a shroicheann an nasc an brabhsálaí, cuireann Kixo an cúltaca atá sábháilte don nasc sin i bhfeidhm.

Conas a osclaítear nasc

Úsáid an t-óstach brandáilte beacht

Baineann óstach nasc Kixo le tionscadal amháin agus bíonn cuma yourbrand.kixo.cc air. D’fhéadfadh iarmhír eile atá á bainistiú ag Kixo a bheith ag tionscadail forbartha. Cóipeáil an t-óstach iomlán ón deais i gcónaí.

Aistriú idir suíomh gréasáin agus QR

Aithníonn an Web SDK tuirlingt ó nasc Kixo go huathoibríoch. Ná húsáid getLinkData() ach nuair a theastaíonn comhthéacs réitithe an fheachtais nó paraiméadair shaincheaptha ó do shuíomh gréasáin ina ródaire féin.

const link = Kixo.getLinkData();

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

Tairg “Oscail san aip” ar an ngréasán soghluaiste

Cuir an URL poiblí iomlán a thugann Kixo ar aghaidh. Ní thaispeántar an meirgí seo ach ar an ngréasán soghluaiste, agus ligeann sé don nasc Kixo an aip suiteáilte, an siopa nó ceann scríbe an tsuímh ghréasáin a roghnú.

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

Lean seisiún deisce ar aghaidh ó chód QR

Má tá QR á thaispeáint laistigh de do shuíomh gréasáin, iarr ar Kixo aistriú a chruthú do nasc atá ann cheana seachas URL a thógáil tú féin. Úsáideann Kixo na cinn scríbe aipe agus suímh ghréasáin atá sábháilte don nasc sin.

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

qrCode.render(handoff.url);

App Links Android

Sula n-athraíonn tú aon chód, sábháil ainm an phacáiste Android agus gach méarlorg sínithe SHA-256 in Aipeanna agus socrú. Má shíníonn Google Play an leagan eisithe, cuir méarlorg Play App Signing leis chomh maith le haon mhéarlorg a úsáidtear i dtógálacha díreacha nó inmheánacha.

1. Cuir an t-óstach leis an manifiost

Cuir an scagaire intinne seo ar an ngníomhaíocht a láimhseálann loingseoireacht na haipe. Ná hathraigh ach sealbhóir áite an óstaigh.

<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. Cuir oscailtí teo ar aghaidh

Léann an Kixo SDK App Link ag tosú fuar. Nuair a athúsáideann Android gníomhaíocht atá ann cheana, cuir an intent nua ar aghaidh ionas go leanfaidh an oscailt theolaí an cosán sannadh agus ródaithe céanna.

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. Fíoraigh Android

Athshuiteáil an aip tar éis duit an manifest a athrú, ansin iarr ar Android an t-óstach a fhíorú agus scrúdaigh an toradh.

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"

Universal Links iOS

Sábháil bundle ID na haipe agus Apple team ID in Aipeanna agus socrú. In Xcode, cumasaigh an cumas Fearainn ghaolmhara ar an sprioc aipe chéanna agus ar an gcumraíocht sínithe chéanna a úsáideann an tógáil suiteáilte.

1. Cuir an fearann gaolmhar leis

applinks:YOUR_EXACT_KIXO_HOST

2. Cuir naisc fhuara agus the ar aghaidh

Roghnaigh an saolré a úsáideann an aip. Seachadann an dá shampla an ceann scríbe réitithe chuig do ródaire féin; ní ghlacann Kixo áit loingseoireacht na haipe.

import Kixo

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

3. Fíoraigh iOS

1. Bain an aip den ghléas, ansin suiteáil an tógáil shínithe.
2. Oscail nasc fíor Kixo ó Notes, Messages, nó Safari. Ná greamaigh isteach i mbarra seoltaí Safari é mar an t-aon tástáil amháin.
3. Deimhnigh go seolann tapáil fhuar an aip chuig an scáileán ceart.
4. Fág an aip ag rith, tapáil an nasc arís, agus deimhnigh an oscailt theolaí.
5. Deimhnigh go bhfuil oscailt an naisc le feiceáil in Kixo.

Coinnigh an ródú laistigh de d’aip

Is féidir le nasc Kixo ceann scríbe ar nós /products/42 a iompar. Mapáil cosáin aitheanta chuig do scáileáin féin agus coinnigh na seiceálacha rochtana atá san aip cheana. Ná húsáid an luach réitithe mar oscailteoir URL ilchuspóireach.

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()
    }
}

Tabhair é seo do chúntóir códaithe

Cuir luachanna ó Socruithe an tionscadail → Aipeanna agus socrú agus Naisc dhomhain in áit na gcúig shealbhóir áite, ansin greamaigh an treoir iomlán isteach i Codex, Claude Code, Cursor, Windsurf, nó cúntóir códaithe eile.

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

Seicliosta eisithe

• Tá an t-óstach beacht Kixo i láthair i socrú Android agus iOS.
• Tuairiscíonn Android go bhfuil an t-óstach fíoraithe don phacáiste eisithe.
• Tá méarloirg sínithe an leagain eisithe sábháilte in Kixo.
• Tá teidlíocht iOS i láthair sa tógáil shínithe den aip.
• Sroicheann oscailtí fuara agus teolaí an scáileán ceart.
• Oibríonn cúltaca an tsuímh ghréasáin nó an tsiopa gan an aip a bheith suiteáilte.
• Tá oscailt an naisc le feiceáil in anailísíocht Kixo.

Treoracha gaolmhara

• Android SDK
• iOS SDK
• Cúntóirí códaithe AI