본문 바로가기
@capgo/capacitor-intent-launcher Device API 오픈 소스

인텐트 런처 Capacitor 플러그인

Intent 시스템으로 Android intent를 실행하고 시스템 설정을 열며 다른 앱과 상호작용

설치

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

가이드

Capacitor에서 Intent Launcher 사용법

기기에서 테스트하기

Capgo 앱을 다운로드한 후 QR code을 스캔하세요.

Intent Launcher 플러그인 미리보기 QR code

@capgo/capacitor-intent-launcher 사용하기

Android intent를 실행하고 Android 및 iOS에서 시스템 설정을 열 수 있는 Capacitor Intent Launcher Plugin입니다.

설치

bun add @capgo/capacitor-intent-launcher
bunx cap sync

bunx cap sync 플러그인의 네이티브 code를 네이티브 프로젝트에 복사합니다. 플러그인을 업그레이드할 때마다 다시 실행하세요.

가져오기

import { IntentLauncher } from '@capgo/capacitor-intent-launcher';

API 한눈에 보기

메서드 설명
startActivityAsync 주어진 action에 대한 Android activity를 시작합니다.
openIOSSettings iOS 설정 화면을 엽니다.
openApplication 패키지 이름으로 앱을 엽니다.
getApplicationIconAsync 앱 아이콘을 base64로 인코딩된 PNG 문자열로 가져옵니다.

예시

startActivityAsync()

주어진 action에 대한 Android activity를 시작합니다.

import { IntentLauncher, ActivityAction } from '@capgo/capacitor-intent-launcher';

// Open location settings
const result = await IntentLauncher.startActivityAsync({
  action: ActivityAction.LOCATION_SOURCE_SETTINGS
});

// Open a specific app settings
const result = await IntentLauncher.startActivityAsync({
  action: ActivityAction.APPLICATION_DETAILS_SETTINGS,
  data: 'package:com.example.app'
});

openIOSSettings()

iOS 설정 화면을 엽니다.

import { IntentLauncher, IOSSettings } from '@capgo/capacitor-intent-launcher';

// Open app settings (recommended - officially supported by Apple)
await IntentLauncher.openIOSSettings({ option: IOSSettings.App });

// Open WiFi settings (may not work in all iOS versions)
await IntentLauncher.openIOSSettings({ option: IOSSettings.WiFi });

openApplication()

패키지 이름으로 앱을 엽니다.

import { IntentLauncher } from '@capgo/capacitor-intent-launcher';

// Open Gmail app
await IntentLauncher.openApplication({ packageName: 'com.google.android.gm' });

getApplicationIconAsync()

앱 아이콘을 base64로 인코딩된 PNG 문자열로 가져옵니다.

import { IntentLauncher } from '@capgo/capacitor-intent-launcher';

const { icon } = await IntentLauncher.getApplicationIconAsync({
  packageName: 'com.google.android.gm'
});
if (icon) {
  const img = document.createElement('img');
  img.src = icon;
}

전체 레퍼런스

‘@capgo/capacitor-intent-launcher 사용하기’에서 계속하기

사용 중이라면 @capgo/capacitor-intent-launcher 사용하기 대시보드 및 API 운영을 계획하려면, 이를 다음과 연결하세요 @capgo/capacitor-intent-launcher @capgo/capacitor-intent-launcher의 구현 세부 사항에 대해서는, 시작하기 Getting Started의 구현 상세 내용은 API 개요 구현 세부 사항은 API 개요에서 소개 Introduction의 구현 상세 내용은, 그리고 API 키 API Keys의 구현 상세 내용은

자주 묻는 질문

Intent Launcher 플러그인 FAQ

Capacitor 앱에 Intent Launcher 플러그인을 어떻게 설치하나요?

"bun add @capgo/capacitor-intent-launcher"(또는 "npm install @capgo/capacitor-intent-launcher")를 실행한 다음 "bunx cap sync"를 실행해 iOS와 Android 프로젝트에 네이티브 code가 반영되게 하세요. 앱 code에서 "@capgo/capacitor-intent-launcher"로 import 하면 됩니다.

@capgo/capacitor-intent-launcher는 React, Vue, Angular와 호환되나요?

네. Intent Launcher는 Capacitor 패키지라서 Ionic, React, Vue, Angular, Svelte, 일반 JavaScript 등 Capacitor에서 실행되는 모든 웹 프레임워크에서 작동합니다.

@capgo/capacitor-intent-launcher은 어떤 Capacitor 버전을 지원하나요?

Capgo 플러그인은 Capacitor의 메이저 버전을 따릅니다. 사용 중인 Capacitor 메이저 버전과 일치하는 플러그인 메이저 버전을 사용하세요 (예: Capacitor 8에는 플러그인 v8). 유지 관리되는 버전은 GitHub README의 호환성 표에서 확인할 수 있습니다.

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

네. code 소스는 GitHub의 https://github.com/Cap-go/capacitor-intent-launcher/에 공개되어 있고, npm에서 무료로 설치할 수 있습니다. 버그 리포트와 pull request는 언제나 환영합니다.

App Store 심사 없이 Intent Launcher를 사용하는 code를 업데이트할 수 있나요?

플러그인을 설치하거나 업그레이드하면 네이티브 code가 변경되므로 새로운 스토어 빌드가 필요합니다. 그 이후에는 플러그인을 호출하는 JavaScript, HTML, CSS 변경 사항을 Capgo live updates로 즉시 배포할 수 있습니다.

앱 리뷰를 기다릴 필요 없이 Intent Launcher 변경 사항을 즉시 배포하세요

스토어 빌드에 플러그인이 포함되면, Capgo live updates로 JavaScript, HTML, CSS 변경 사항을 몇 분 만에 사용자에게 푸시할 수 있습니다.

Capgo로 시작하기