Langsung ke konten utama
Deep Linking

Cara Integrasi Universal Links di Next.js dengan Capacitor

Pelajari langkah demi langkah cara mengatur universal links untuk aplikasi Next.js Anda dengan Capacitor di platform iOS dan Android.

Ilustrasi blog: Cara Mengintegrasikan Universal Links di Next.js dengan Capacitor Capgo

Universal links di iOS dan App Links di Android memungkinkan pengguna langsung masuk ke aplikasi Anda dari sebuah link, tanpa melalui browser. Ini sangat berguna untuk meningkatkan user experience dan menjaga konteks dari halaman web ke aplikasi. Dalam panduan ini, kami akan membahas proses setup deep links ini untuk aplikasi Next.js menggunakan Capacitor. Untuk atribusi dan deferred deep links, @capgo/capacitor-appsflyer dapat mengarahkan kampanye install ke layar in-app yang tepat.

Setup deep links tidak membutuhkan banyak code, namun tetap memerlukan beberapa konfigurasi. Di akhir panduan ini, Anda akan bisa mengklik link seperti https://www.capgo.app/details/22 dan buka aplikasi Anda ke halaman yang tepat jika sudah terinstal.

Pertama, kita akan buat app Next.js baru dan halaman detail untuk testing:

npx create-next-app@latest capgoLinks
cd capgoLinks
mkdir pages/details
touch pages/details/[id].js
npm run build
npx cap add ios
npx cap add android

Pastikan bundle ID sudah diatur dengan benar di capacitor.config.json file, karena ini sangat krusial untuk setup:

{
  "appId": "com.capgo.deeplinks",
  "appName": "capgoLinks",
  "webDir": "out",
  "bundledWebRuntime": false
}

Untuk routing, Next.js menggunakan file-based routing, jadi dengan membuat file di pages/details/[id].js, kita sudah menyiapkan wildcard route kita.

Di pages/details/[id].js, kita bisa mengambil ID dari URL menggunakan router bawaan Next.js:

import { useRouter } from 'next/router'

function DetailsPage() {
  const router = useRouter()
  const { id } = router.query

  return (
    <div>
      <p>My ID: {id}</p>
    </div>
  )
}

export default DetailsPage

Sekarang, mari kita tangani appUrlOpen event dengan Capacitor. Event ini dipicu saat aplikasi dibuka melalui custom URL scheme. Tambahkan listener di pages/_app.js file Anda:

import { useEffect } from 'react'
import { App } from '@capacitor/app'

function MyApp({ Component, pageProps }) {
  useEffect(() => {
    App.addListener('appUrlOpen', (event) => {
      const slug = event.url.split('.app').pop()
      if (slug)
        window.location.href = slug

    })
  }, [])

  return <Component {...pageProps} />
}

export default MyApp

code ini mendengarkan appUrlOpen event dan melakukan navigasi ke route yang sesuai di dalam aplikasi Next.js Anda.

Konfigurasi iOS

Untuk iOS, Anda memerlukan app ID dengan Associated Domains yang sudah aktif. Buat file apple-app-site-association file dengan konten berikut, ganti YOURTEAMID dan com.your.bundleid dengan team ID dan bundle ID asli Anda:

{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appID": "YOURTEAMID.com.your.bundleid",
        "paths": ["*"]
      }
    ]
  }
}

Upload file ini ke .well-known direktori di domain Anda, sehingga dapat diakses di https://www.capgo.app/.well-known/apple-app-site-association.

Di Xcode, tambahkan domain ke entitlements aplikasi Anda dengan format applinks:capgo.app.

Konfigurasi Android

Untuk Android App Links, ikuti langkah-langkah berikut:

  1. Buat file keystore jika Anda belum memilikinya.
  2. Ambil fingerprint SHA256 dari keystore.
  3. Buat file assetlinks.json yang berisi package name dan fingerprint SHA256 Anda.
  4. Upload file ini ke .well-known direktori di domain Anda.

Di AndroidManifest.xml, tambahkan intent-filter ke dalam activity elemen yang menangani deep link:

<activity ...>
  <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="capgo.app" />
  </intent-filter>
</activity>

Setelah mengunggah assetlinks.json file, Anda dapat memverifikasinya menggunakan alat Digital Asset Links dari Google. Jika semuanya sudah diatur dengan benar, Anda akan melihat tanda centang hijau.

Untuk build dan menandatangani aplikasi Anda, gunakan perintah berikut:

cd android
./gradlew assembleRelease
cd ..
jarsigner -verbose -sigalg SHA1withRSA -digestalg SHA1 -keystore my-release-key.keystore android/app/build/outputs/apk/release/app-release-unsigned.apk alias_name
zipalign -v 4 android/app/build/outputs/apk/release/app-release-unsigned.apk capgo.apk
adb install capgo.apk

Ini akan menginstal aplikasi yang sudah ditandatangani ke perangkat Android yang terhubung.

Capacitor Konfigurasi untuk Pengaturan Proyek Native

Untuk mengotomatiskan pengaturan proyek native, pertimbangkan untuk menggunakan paket Capacitor configure. Instal di proyek Anda:

npm install @capacitor/configure

Buat file capacitor.config.yaml file di root proyek Anda:

vars:
  BUNDLE_ID: com.capgo.deeplinks
  PACKAGE_NAME: com.capgo.deeplinks
platforms:
  ios:
    targets:
      App:
        bundleId: $BUNDLE_ID
    entitlements:
      - com.apple.developer.associated-domains: ['applinks:capgo.app']
  android:
    packageName: $PACKAGE_NAME

Jalankan alat configure dengan konfigurasi ini:

npx cap-config run capacitor.config.yaml

Ini akan menerapkan pengaturan yang ditentukan dalam file YAML ke proyek native Anda.

Kesimpulan

Mengatur deep link dengan Capacitor untuk aplikasi Next.js melibatkan konfigurasi domain dan pengaturan proyek untuk iOS dan Android. Meskipun prosesnya memerlukan perhatian pada detail, alurnya lebih ringkas dibandingkan metode lama dan tidak memerlukan plugin tambahan. Pastikan file verifikasi domain Anda disajikan dengan benar dan periksa menggunakan alat platform terkait. Setelah diatur, aplikasi Anda akan terbuka mulus dari tautan web, memberikan transisi yang lancar bagi pengguna dari web ke aplikasi.

Jika Anda menggunakan Cara Integrasi Universal Links di Next.js dengan Capacitor untuk merencanakan pekerjaan plugin native, hubungkan dengan Direktori Plugin Capgo untuk alur kerja produk di Direktori Plugin Capgo, Plugin Capacitor oleh Capgo untuk detail implementasi pada Capacitor Plugins oleh Capgo Menambahkan atau Memperbarui Plugin untuk detail implementasi pada Menambahkan atau Memperbarui Plugin, Alternatif Plugin Ionic Enterprise untuk alur kerja produk di alternatif plugin Ionic Enterprise, dan Capgo Native Build untuk alur kerja produk di Capgo Native Builds.

Live updates untuk aplikasi Capacitor

Saat bug web-layer sudah live, kirim perbaikannya lewat Capgo alih-alih menunggu berhari-hari untuk persetujuan app store. Pengguna mendapat update di background, sementara perubahan native tetap mengikuti jalur review normal.

Terbaru dari Blog kami

Capgo memberikan insight terbaik yang Anda butuhkan untuk membuat aplikasi mobile yang benar-benar profesional.