링킹 (Linking)
앱 설정 화면, 외부 브라우저, 인앱 브라우저를 여는 모듈입니다.
개요
appify.linking은 앱 외부의 화면이나 URL을 여는 기능을 제공합니다. openSettings는 권한을 수동으로 변경해야 할 때 시스템 설정 화면으로 이동하며, externalBrowser와 inappBrowser는 각각 기기 기본 브라우저와 앱 내 웹뷰 레이어로 URL을 엽니다. 모든 메서드는 동작 성공 여부를 boolean으로 반환합니다.
API
openSettings(): Promise<boolean>
앱의 시스템 설정 화면을 엽니다.
매개변수
없음
반환값: Promise<boolean> - 설정 화면 열기 성공 여부
예제
import { appify } from '@nolraunsoft/appify-sdk';
await appify.linking.openSettings();
externalBrowser(url: string): Promise<boolean>
시스템 기본 웹 브라우저(Safari, Chrome 등)로 URL을 엽니다.
매개변수
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
| url | string | 예 | 열 URL 문자열 |
반환값: Promise<boolean> - 브라우저 열기 성공 여부
예제
import { appify } from '@nolraunsoft/appify-sdk';
await appify.linking.externalBrowser('https://google.com');
inappBrowser(url: string): Promise<boolean>
앱 내 별도 웹뷰 레이어로 URL을 엽니다.
매개변수
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
| url | string | 예 | 열 URL 문자열 |
반환값: Promise<boolean> - 인앱 브라우저 열기 성공 여부
예제
import { appify } from '@nolraunsoft/appify-sdk';
await appify.linking.inappBrowser('https://github.com');
플랫폼별 참고사항
openSettings는 앱별 설정 화면으로 이동하며, 전체 설정 앱 루트가 아닌 해당 앱의 권한 설정 페이지로 이동합니다.externalBrowser는 iOS에서 Safari, Android에서 기기 기본 브라우저를 사용합니다.