브라우저에서 모바일 애플리케이션 열기.
Open Mobile Application From The Browser( web) , intent, deeplink, url scheme
https://vhudyma-blog.eu/open-mobile-application-from-the-browser/
딥링킹 유형
딥 링크에는 두 가지 주요 유형이 있습니다.
- 기본
- 링크는 응용 프로그램이 설치되어 있으면 열리고 그렇지 않으면 오류 메시지가 표시됩니다.
- 연기
- 링크는 애플리케이션이 설치되어 있으면 열리고, 그렇지 않으면 사용자가 Play 또는 App Store(또는 선택한 다른 위치)로 리디렉션됩니다.
이 외에도 Contextual Deep Linking 에 대해 들어보셨을 것입니다 .
상황별 딥 링크는 일반적으로 사용자에 대한 추가 정보를 수집하기 위해 추가된 일부 추가 매개변수와 함께 기본이거나 지연됩니다.
딥 링크 생성
모바일 앱에 대한 지연 딥 링크를 만들어 설치하면 열리며, 그렇지 않으면 사용자가 다운로드할 수 있는 스토어로 리디렉션합니다.
중요 참고 사항: 이 솔루션은 모든 브라우저 또는 이전 Android/iOS 버전에서 작동하지 않을 수 있습니다. 그러나 Chrome 및 Safari에서는 제대로 작동해야 합니다.
기계적 인조 인간
Android의 경우 Google은 의도 URL을 제공합니다.
// Android Intent Syntax
intent:
HOST/URI-path // Optional Host
#Intent;
package=\[string\];
action=\[string\];
category=\[string\];
component=\[string\];
scheme=\[string\];
end;
// Android Code
const url = "intent://APP_HOST/#Intent;scheme=APP_NAME;package=APP_PACKAGE;end";
window.location.replace(url);
APP_NAME 및 APP_PACKAGE 를 모바일 앱에 속한 값 으로 대체해야 합니다 . APP_HOST 는 필요하지 않을 수 있는 선택적 호스트 값입니다(다음 예에서 인스타그램 앱을 여는 데 필요함).
Instagram의 예제 코드:
// Open Instagram
const url = "intent://instagram.com/#Intent;scheme=https;package=com.instagram.android;end";
window.location.replace(url);
IOS
iOS에서 모바일 앱을 열고 앱이 설치되지 않은 경우에만 실행되는 시간 제한을 몇 초로 설정합니다.
window.location.replace("APP_NAME");
// Wait 10s and redirect to App Store if app was not opened
setTimeout(() => {
window.location.replace("APP_STORE_URL");
}, 10000);
APP_NAME 및 APP STORE URL 을 모바일 애플리케이션에 속한 값 으로 대체해야 합니다.
Instagram의 예제 코드:
window.location.replace("instagram://");
setTimeout(() => {
window.location.replace("https://apps.apple.com/us/app/instagram/id389801252");
}, 10000);
완전한 예
모든 코드를 통합하기 위해 간단한 React 애플리케이션을 만들어 보겠습니다.
npx create-react-app deep-linking
사용자의 운영 체제를 감지하는 데 도움이 되는 react-device-detect 라이브러리를 설치합니다 .
yarn add react-device-detect
앱 구성 요소를 열고 다음 코드로 바꿉니다.
import React, { useEffect } from "react";
import { isAndroid, isIOS } from "react-device-detect";
const App = () => {
useEffect(() => {
if (isAndroid) {
const url =
"intent://instagram.com/#Intent;scheme=https;package=com.instagram.android;end";
window.location.replace(url);
} else if (isIOS) {
window.location.replace("instagram://");
setTimeout(() => {
window.location.replace(
"https://apps.apple.com/us/app/instagram/id389801252"
);
}, 10000);
} else {
window.location.replace("https://instagram.com");
}
}, []);
return (
<div className="App">
<div>
If you have not been automatically redirected, click on the following link:
</div>
{isAndroid ? (
<a href="https://play.google.com/store/apps/details?id=com.instagram.android">
Open Android app
</a>
) : isIOS ? (
<a href="https://apps.apple.com/us/app/instagram/id389801252">
Open iOS app
</a>
) : (
<a href="https://instagram.com">Open Web app</a>
)}
</div>
);
};
export default App;
중요 참고 사항: 브라우저에 URL을 수동으로 입력하여 iOS 또는 Android에서 테스트하지 마십시오. 작동하지 않습니다. React 앱을 가리키는 링크를 만들고 클릭하여 테스트합니다.
요약
모바일 앱 딥링킹은 매우 복잡한 주제입니다.
모든 시나리오에 적합한 솔루션을 준비하는 것은 매우 어렵습니다.
다행히도 항상 스스로 처리할 필요는 없습니다. 링크를 생성하고 내부에서 모든 리디렉션 논리를 수행하는 유료 서비스가 많이 있습니다.
웹 브라우저에서 앱 열기
URL Scheme
사용자를 앱의 특정 콘텐츠로 바로 연결하는 URL 이다.
ex) naversearchapp://
위와 같은 URL Scheme를 이용하면 브라우저에서 해당 Scheme를 읽고 그 Scheme에 해당하는 앱이 있는 경우 (앱에서 설정) 열어준다.
하지만 다음과 같은 한계가 있다.
- naversearchapp 같이 앞에 붙는 스키마는 유니크한 값이 아니기 때문에 같은 이름이 있을 경우 어떤앱을 열지 물어보게된다.
- 앱이 미설치되어있는 경우 동작하지 않는다.
Android
intent filter
https://developer.android.com/guide/components/intents-filters?hl=ko
이 intent filter의 역할은 앱 열기에 한정된 것이 아니고 특정 앱으로의 메시징을 처리하는 객체인데, 이걸 딥링크처럼 활용할 수 있다.
앱에서 intent관련 설정을 지정하고, 웹에서 intent:// 와 같이 실행하면 앱을 실행할 수 있다.
이 방법은 위 URL 스키마 방식의 한계를 없애준다.
패키지명을 이용하기 때문에 유니크하고, 앱이 미설치되어있는 경우 해당 패키지에 해당되는 playstore로 이동한다.
Applink
https://developer.android.com/training/app-links/verify-site-associations?hl=ko
위 인텐트 필터 방식을 활용하여 웹사이트 URL 기반으로 앱을 여는 방식 (android 6.0 이상지원)
예를들어 https://medium.com 를 방문하는 경우 해당하는 앱을 열 수 있다.
웹에서는 무엇을 해주어야 하나?
기본적으로 인텐트 필터 설정은 앱쪽에서 해주지만, 웹에서도 해줘야할 것이 있다.
앱링크를 제공할 도메인이 특정 앱과 매칭된다는 것을 알려주기 위해 앱쪽에서 생성하는 assetlinks.json 를 https://{도메인}/.well-known/assetlinks.json 에 제공해줘야한다.
여기에는 몇 가지 제약이 따르게 되는데,
- HTTPS만 지원한다.
- assetlinks.json 를 가져오는데에 있어서 리디렉션이 일어나지 않아야하고 application/json 타입으로 응답되어야한다.
- 서브도메인이 다른 경우 모두 assetlinks.json 제공이 필요하다. 예를들어 www.medium.com 와 m.medium.com 가 존재한다면, assetlinks.json 를 모두 제공해야한다.
- robot.txt 가 접근가능해야한다. 즉, VPN 등이 있어야 접근가능한 경우 적용 불가능하다.
테스트는 어떻게하지?
이부분이 제일 골치아팠는데, 위와 같은 제약사항이 있기 때문에 VPN을 사용하거나 사내망이 따로 있는 경우 테스트하기가 번거롭다.
예를들어, 개발환경인 dev.aa.com 가 있고, 실제환경인 aa.com 이 있다고 했을 때 위 제약사항이 있기 때문에 assetlinks.json을 두 환경을 제공하는 서버 각각 넣어줘야한다.
대부분에 개발환경 서버는 VPN 뒤에 있기 때문에 위 4번 제약사항에 걸리게 된다.
이 때 찾아보았던 해결할 수 있는 방법은
- 만약 dev.aa.com 과 aa.com 과 같이 서브도메인 / 루트도메인의 관계라면 루트도메인에 assetlinks를 *.aa.com 과같이 설정함으로써 적용이 가능하다.
- app.dev.aa.com 과 같은 서버를 실제환경에 열어두고 여기서 테스트를 진행한다.
앱이 설치되어있지 않은 경우는?
기본적으로 앱링크 / 유니버셜링크는 앱이 설치되어있지 않은 경우 단순히 웹에서 해당 url을 표시하게 된다. 이런 경우 보통 "앱으로 이동" 과 같은 버튼을 표시하고, 클릭시 위에서 말한 인텐트 필터를 사용하게 된다.
iOS
ios의 경우 deffered deep link나 intent 필터 등의 기법은 없고 universal 링크만 이용 가능하다. (ios 9 이상)
Universal link
https://developer.apple.com/ios/universal-links/
기본적으로 app link와 동일하다. 웹사이트 URL 기반으로 앱을 열게 동작해준다.
웹에서는 무엇을 해주어야 하나?
안드로이드와 마찬가지로 .well-known 하위에 파일 추가가 필요하다. (다른점은 루트 디렉토리에 넣어도 무방)
앱쪽에서 생성한 apple-app-site-association 파일을 넣어주게되는데, 마찬가지로 application/json 타입 제공이 필요하다.
주의할 점은, 안드로이드의 경우 assetlinks.json 의 파일 포맷이 json 이라 브라우저가 알아서 json 으로 처리해주는 반면, 해당 파일은 파일 포맷이 없으므로, 명시적으로 제공이 필요하다.
기본적인 제약사항 (VPN X, redirect X, 서브도메인지원 X)은 앱링크와 동일하다.
따로 문서에 명시되어있지는 않은데, 테스트 결과 앱링크와 마찬가지로 앱쪽에서 *.루트도메인 과 같이 설정한 경우 루트도메인에 넣은 설정파일로 서브도메인 지원이 가능하다.
앱이 설치되어있지 않은 경우는?
마찬가지로 앱열기버튼을 제공할 수 있다. (특히 유니버셜링크는 safari의 경우 앱열기버튼을 네이티브에서 제공하고 있다)
다만, iOS에서는 인텐트 필터처럼 앱의 설치여부를 구분해서 동작할 수 없기 때문에 조금 추가작업이 필요하다.
다음과 같은 방법을 고려할 수 있다.
- firebase 다이나믹링크, 브랜치 등 외부 서비스를 이용하는 방식 (ex ) Medium, reddit )
- 위 서비스들이 앱 설치/미설치시 분기처리를 제공해준다. Android의 경우 내부적으로 인텐트 필터를 이용하는 것으로 보인다.
- 직접 처리하는 방식
- 라우트를 https://aa.com/launchApp 과 같이 지정해놓고, 해당 라우트로 리디렉션 시킨다.
- 만약 앱이 설치되어 있다면 유니버셜링크를 통해 서버에 접근하지않고 바로 앱이 열릴테고, 앱이 설치되어있지 않다면 해당 라우트로 들어오고 fe 서버에서 app store로 리디렉션 시킬 수 있다.
'프로그래밍 > App' 카테고리의 다른 글
What’s next for Flutter (0) | 2023.02.01 |
---|---|
딥링크(Deeplink) : URI스킴, 유니버셜 링크, 앱링크 구분과 이해 (0) | 2022.08.03 |
[리눅스] Linux - process kill all killall 프로세스이름으로 종료하기 (0) | 2021.04.22 |
FlutterEngage - 모바일 앱에서 웹 앱으로 (0) | 2021.04.07 |
[AMD] 라이젠 가상화 설정 (0) | 2021.03.31 |