메인 콘텐츠로 건너뛰기
@capgo/capacitor-inappbrowser UI & 시스템 인앱 브라우저 플러그인은 @capgo/inappbrowser에서 @capgo/capacitor-inappbrowser로 이름이 바뀌었습니다. Capacitor In-App Browser 오픈 소스

인 앱 브라우저 Capacitor 플러그인

__CAPGO_KEEP_0__ 플러그인을 사용하여 관리되는 인 앱 웹 뷰를 개방하고, 네이티브 UI 층을 제공하며, 개인적인 세션, 다운로드, 프록시, 메시징을 지원합니다.

설치

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

사용 방법

Capacitor에서 In App Browser 사용하는 방법

장치에서 테스트

다운로드 Capgo 앱, 그리고 QR code를 스캔하세요.

@code/__CAPGO_KEEP_1__-inappbrowser를 사용하여

@capgo/capacitor 내 애플리케이션 브라우저

@capgo/capacitor-inappbrowser 외부 웹 콘텐츠를 Capacitor 앱에서 열 수 있습니다. 사용 open() for the platform browser surface, or openWebView() when your app needs a managed native WebView with custom size, toolbar, messages, scripts, downloads, proxying, popup control, private storage, or Ionic UI layered above the page.

설치

npm install @capgo/capacitor-inappbrowser
npx cap sync

이 플러그인은 다음을 제공합니다.

  • Android와 iOS에서 Chrome Custom Tabs를 사용하는 시스템 브라우저 흐름 SFSafariViewController Android와 iOS에서.
  • Capacitor 앱 위에 숨기거나 표시, 뒤로 보내기, 다시 앞으로 보내기, 크기 조정할 수 있는 관리되는 웹 뷰
  • 앱 UI가 브라우저 위에 있을 때 클릭, 터치, 스크롤 전달 dispatchInputEvent() 앱 UI는 브라우저 위에 위치합니다.
  • Android 및 iOS에서 native WebView 프레임 외부의 탭은 Capacitor 앱으로 전달됩니다.
  • , persistWebViewData, clearCookies, clearAllCookies, clearCache앱에서 페이지로의 통신 clearAllBrowsingData.
  • , postMessage()페이지에서 앱으로의 통신 window.mobileApp.postMessage(...)Live Update executeScript().
  • Cloudflare _blank Capacitor

GitHub

Capgo

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

code

API

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

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

SDK

CLI

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

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

npm

bun

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

다운로드 처리, 네이티브 우선 프록시 규칙, 팝업 제어, Google Pay 지원,

웹 앱을 내장하세요

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' },
});

문서 포털, 업로드 흐름, 지원 데스크, 비디오 통화, Google Pay 페이지 또는 앱 셸을 떠나지 않고도 네이티브 앱 제어가 필요한 인터랙티브 웹 앱을 위한 이 패턴을 사용하세요.

전체 참조

@capgo/capacitor-inappbrowser

__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-inappbrowser를 사용하고 있다면 capgo/capacitor-inappbrowser를 연결하세요 __CAPGO_KEEP_0__/__CAPGO_KEEP_1__-inappbrowser의 구현 세부 사항을 참조하세요 @capgo/capacitor-inappbrowser @capgo/capacitor-inappbrowser 시작하기 시작하기 구현 세부 사항에 대해 Capgo 플러그인 디렉토리 Capgo 플러그인 디렉토리에서 제품 워크플로에 대해 Capacitor Capgo 플러그인 Capacitor Capgo 플러그인 구현 세부 사항 및 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트 구현 세부 사항에 대해

FAQ

In App Browser 플러그인 FAQ

How do I install the In App Browser plugin in a Capacitor app?

Run "bun add @capgo/capacitor-inappbrowser" (또는 "npm install @capgo/capacitor-inappbrowser")를 실행한 후 "bunx cap sync"를 실행하여 iOS와 Android 프로젝트가 네이티브 code를 인식하도록 하세요. 그리고 앱 code에서 "@capgo/capacitor-inappbrowser"를 import하세요.

React, Vue 및 Angular과 함께 @capgo/capacitor-inappbrowser이 작동하나요?

네. In App Browser는 Capacitor 패키지이므로, Capacitor 내부에서 실행되는 모든 웹 프레임워크와 함께 작동합니다. 예를 들어 Ionic, React, Vue, Angular, Svelte 및 단순한 JavaScript도 포함됩니다.

어떤 Capacitor 버전이 @capgo/capacitor-inappbrowser을 지원하나요?

Capgo plugins follow Capacitor's major version: use the plugin major version that matches your Capacitor major version (for example plugin v8 with Capacitor 8). The compatibility table in the GitHub README lists the maintained versions.

@capgo/capacitor-inappbrowser는 무료이며 오픈 소스인가요?

네. code의 소스는 GitHub에 https://github.com/Cap-go/capacitor-inappbrowser/ 에 공개되어 있으며 npm에서 무료로 설치할 수 있습니다. 버그 리포트와 풀 리퀘스트는 환영합니다.

code가 In App Browser를 사용하는 경우 App Store 리뷰 없이 업데이트가 가능한가요?

code를 설치하거나 업그레이드하면 네이티브 code이 변경되므로 새로운 스토어 빌드를 해야 합니다. 그 후에 Capgo live updates를 통해 JavaScript, HTML 및 CSS 변경 사항이 바로 배포될 수 있습니다.

앱 리뷰 기다리지 않고 In App Browser 변경을 배포하세요.

플러그인이 스토어 빌드에 포함되면 Capgo Live Update는 사용자에게 몇 분만에 JavaScript, HTML 및 CSS 변경을 푸시합니다.

Capgo로 시작하세요.