Langsung ke konten utama
@capgo/capacitor-inappbrowser Ganti nama Namanya diubah dari @capgo/inappbrowser menjadi @capgo/capacitor-inappbrowser. UI & Sistem Open source

In-App Browser plugin Capacitor

Buka WebView in-app terkelola dengan layering UI native, sesi privat, download, proxy, dan messaging

Instal

bun add @capgo/capacitor-inappbrowser bunx cap sync
npm, pnpm atau yarn
  • npm install @capgo/capacitor-inappbrowser
  • pnpm add @capgo/capacitor-inappbrowser
  • yarn add @capgo/capacitor-inappbrowser

Panduan

Cara menggunakan In App Browser di Capacitor

Tes di perangkat

Download aplikasi Capgo, lalu scan QR code.

QR pratinjau plugin In App Browser code

Menggunakan @capgo/capacitor-inappbrowser

@capgo/capacitor-inappbrowser membuka konten web eksternal dari aplikasi Capacitor. Gunakan open() untuk tampilan browser platform, atau openWebView() saat aplikasi Anda membutuhkan WebView native terkelola dengan ukuran kustom, toolbar, pesan, script, download, proxy, kontrol popup, penyimpanan privat, atau Ionic UI di atas halaman.

Instal

npm install @capgo/capacitor-inappbrowser
npx cap sync

Apa yang Diekspos Plugin Ini

  • Alur browser sistem dengan Chrome Custom Tabs di Android dan SFSafariViewController di iOS.
  • WebView yang dikelola, dapat diukur, disembunyikan, ditampilkan, dipindahkan ke belakang aplikasi Capacitor, dan dikembalikan ke depan.
  • Penerusan klik, sentuh, dan gulir dengan dispatchInputEvent() ketika UI aplikasi berada di atas browser.
  • Browser layar parsial di mana sentuhan di luar bingkai WebView native diteruskan ke aplikasi Capacitor di Android dan iOS.
  • Pembersihan cookie, cache, dan data penelusuran lengkap dengan persistWebViewData, clearCookies, clearAllCookies, clearCache, dan clearAllBrowsingData.
  • Komunikasi aplikasi-ke-halaman dengan postMessage(), komunikasi halaman-ke-aplikasi dengan window.mobileApp.postMessage(...), dan script injection dengan executeScript().
  • Penanganan download, aturan proxy native-first, kontrol popup, dukungan Google Pay, _blank penanganan link, dan instance browser preloadable yang tersembunyi.

Kasus Penggunaan Umum

Letakkan UI App di Atas Browser Live

import { InAppBrowser } from '@capgo/capacitor-inappbrowser';

const { id } = await InAppBrowser.openWebView({
  url: 'https://example.com/checkout',
  toBack: true,
  transparentBackground: true,
});

await InAppBrowser.dispatchInputEvent({
  id,
  type: 'click',
  x: 160,
  y: 420,
});

await InAppBrowser.bringToFront({ id });

Gunakan ini untuk overlay checkout, alur pembayaran berbasis browser, alur panduan dukungan, atau fitur apa pun di mana kontrol Ionic harus tetap di atas konten web live.

Jaga App Tetap Dapat Diklik di Sekitar Browser Sheet

const { id } = await InAppBrowser.openWebView({
  url: 'https://example.com/offers',
  height: window.innerHeight - 200,
  y: 0,
});

await InAppBrowser.updateDimensions({ id, height: window.innerHeight });

Browser dengan ukuran kustom hanya menangkap sentuhan di dalam bingkainya. Area app yang terlihat lainnya tetap dapat disentuh di Android dan iOS.

Hindari Sesi Web yang Persisten

const { id } = await InAppBrowser.openWebView({
  url: 'https://example.com/login',
  persistWebViewData: false,
});

await InAppBrowser.clearAllBrowsingData();
await InAppBrowser.close({ id });

Gunakan ini untuk pengalihan akun, pengujian checkout, impersonasi dukungan, atau alur autentikasi di mana cookie, cache, local storage, dan IndexedDB tidak boleh bertahan lebih lama dari yang diperlukan.

Preload dan Ganti Beberapa WebView

const first = await InAppBrowser.openWebView({ url: 'https://example.com/a', hidden: true });
const second = await InAppBrowser.openWebView({ url: 'https://example.com/b', hidden: true });

await InAppBrowser.show({ id: first.id });
await InAppBrowser.hide({ id: first.id });
await InAppBrowser.show({ id: second.id });

Instance tersembunyi menjaga state mereka tetap tersedia sambil menghindari overlay native yang menghalangi sentuhan app.

Sematkan Web App Lanjutan

const { id } = await InAppBrowser.openWebView({
  url: 'https://example.com/portal',
  handleDownloads: true,
  openBlankTargetInWebView: true,
  hiddenPopupWindow: true,
  outboundProxyRules: [
    {
      urlRegex: '^https://example\\.com/api/',
      action: 'delegateToJs',
    },
  ],
});

await InAppBrowser.postMessage({
  id,
  detail: { source: 'app', action: 'refresh' },
});

Gunakan pola ini untuk portal dokumen, alur upload, meja dukungan, panggilan video, halaman Google Pay, atau web app interaktif yang membutuhkan kontrol aplikasi native tanpa keluar dari shell aplikasi.

Referensi Lengkap

Lanjutkan dari Menggunakan @capgo/capacitor-inappbrowser

Jika Anda menggunakan Menggunakan @capgo/capacitor-inappbrowser untuk merencanakan pekerjaan plugin native, hubungkan dengan @capgo/capacitor-inappbrowser untuk detail implementasi di @capgo/capacitor-inappbrowser, Panduan Memulai untuk detail implementasi di Getting Started, Direktori Plugin Capgo untuk alur kerja produk di Direktori Plugin Capgo, Plugin Capacitor oleh Capgo untuk detail implementasi di Plugin Capacitor oleh Capgo, dan Menambahkan atau Memperbarui Plugin untuk detail implementasi di bagian Menambahkan atau Memperbarui Plugin.

FAQ

FAQ plugin In App Browser

Bagaimana cara install plugin In App Browser di aplikasi Capacitor?

Jalankan "bun add @capgo/capacitor-inappbrowser" (atau "npm install @capgo/capacitor-inappbrowser"), lalu jalankan "bunx cap sync" agar proyek iOS dan Android mendeteksi code native. Import dari "@capgo/capacitor-inappbrowser" di dalam code aplikasi Anda.

Apakah @capgo/capacitor-inappbrowser mendukung React, Vue, dan Angular?

Ya. In App Browser adalah package Capacitor, jadi bisa dipakai dengan framework web apa pun yang berjalan di dalam Capacitor, termasuk Ionic, React, Vue, Angular, Svelte, dan JavaScript biasa.

Versi Capacitor mana yang didukung @capgo/capacitor-inappbrowser?

Plugin Capgo mengikuti versi mayor Capacitor: gunakan versi mayor plugin yang sesuai dengan versi mayor Capacitor Anda (contoh: plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub mencantumkan versi yang masih di-maintain.

Apakah @capgo/capacitor-inappbrowser gratis dan open source?

Ya. Source code tersedia untuk publik di GitHub pada https://github.com/Cap-go/capacitor-inappbrowser/ dan paketnya gratis untuk diinstal dari npm. Laporan bug dan pull request sangat diterima.

Bisakah saya memperbarui code yang menggunakan In App Browser tanpa review App Store?

Instalasi atau upgrade plugin akan mengubah native code, jadi butuh build store baru. Setelah itu, perubahan JavaScript, HTML, dan CSS yang memanggil plugin bisa langsung dikirim lewat live updates Capgo.

Rilis perubahan In App Browser tanpa menunggu review aplikasi

Setelah plugin ada di build store Anda, live updates Capgo akan mengirim perubahan JavaScript, HTML, dan CSS ke pengguna dalam hitungan menit.

Mulai dengan Capgo