[AOS] Android DeepLink 설정

 

 

 

🐱

오소리님, 딥링크로 MainActivity를 띄워주시고, name 값을 받게 구현해주세요~

딥링크... 가 모죠...?

🐶

 

 

 

🐱

구현해주세요.

네...

🐶

 

 

 

 

 

딥링크란

딥 링크는 사용자를 앱의 특정 콘텐츠로 바로 연결하는 URL이다.

연결을 원하는 activity의 intent filter에 딥 링크를 설정하면 deeplink를 누른 사용자에게 해당 activity를 띄워준다.

 

 

딥링크 만들기

앱 콘텐츠 딥 링크 만들기  |  Android 개발자  |  Android Developers

 

 

1. 커스텀 scheme, host 값 정의

편의를 위해 string.xml에 scheme과 host 값을 정의해준다.

 

<resources>
	...
    <string name="deeplink_scheme">deeplink</string>
    <string name="deeplink_host">main</string>
</resources>

 

 

2. AndroidMenifest.xml 설정

딥링크에 연결되어 화면에 출력할 activity에 VIEW action과 BROWSSABLE, DEFAULT 카테고리를 포함한다.

또한 URI 형식을 나타내는 data 태그에 위에서 정의한 scheme과 host를 넣어준다.

 

<application
	...>
    <activity
    	...>
        <intent-filter>
        	<action android:name="android.intent.action.MAIN" />
            <category android:name="android.intent.category.LAUNCHER" />
        </intent-filter>
        <intent-filter>
            <action android:name="android.intent.action.VIEW" />

            <category android:name="android.intent.category.DEFAULT" />
            <category android:name="android.intent.category.BROWSABLE" />

            <data android:host="@string/deepilnk_host"
                android:scheme="@string/deeplink_scheme" />
        </intent-filter>
    </activity>
    ...
</application>

 

 

 

Deeplink 테스트 해보기

* 에뮬레이터를 이용한 테스트 입니다.

 

Android 디버그 브리지(adb)  |  Android 개발자  |  Android Developers

 

 

Android Studio 하단의 Terminal을 이용하면 된다.

 

 

1. 실행되어 있는 에뮬레이터 확인해보기

 

$  adb devices
  List of devices attached
  emulator-5556 device

 

에뮬레이터가 실행되어 있지 않은 경우

$  adb devices
  adb: device offline

 

위와 같이 실행되어 있는 에뮬레이터가 없는 경우 당황하지 않고 에뮬레이터를 켜주면 된다.

 

 

좌측 상단에서 에뮬레이터를 선택 후 실행해주거나

 

상단 좌측 Device Manager 탭에서 에뮬레이터를 실행해준다.

 

 

실행되어 있는 에뮬레이터가 여러대인 경우

$  adb devices
  List of devices attached
  emulator-5556 device
  emulator-5558 device

 

 

아래 명령어를 실행해 특정 에뮬레이터 shell에서 명령어를 입력할 수 있도록 한다.

 

$  adb -s emulator-5556 shell

 

 

 

2. deeplink 실행 명령어

 

$   adb shell am start -W -a android.intent.action.VIEW -d "deeplink://main?name=test!!" com.딥링크.프로젝트.패키지명
  Starting: Intent { act=android.intent.action.VIEW dat=test://main?name=test!! pkg=com.딥링크.프로젝트.패키지명 }
  Status: ok
  LaunchState: WARM
  Activity: com.딥링크.프로젝트.패키지명.activity.MainActivity
  TotalTime: 907
  WaitTime: 914
  Complete

 

중간의 "deeplink://main?name=test!!" 에서

deeplink는 위에서 string.xml에 정의한 scheme값, main은 host 값이다.

name=test!!는 해당 activity에 전달할 데이터, 즉 name이라는 intent에 test!!라는 데이터를 전달해 주는 역할을 한다.

 

 

$   adb shell am start -W -a android.intent.action.VIEW -d "deeplink://main?name=test!!" com.딥링크.프로젝트.패키지명
  adb: more than one device/emulator

 

명령어 실행 후 위와 같은 오류가 발생하면 위에서 언급한 실행되어 있는 에뮬레이터가 여러대인 경우이기 때문에 특정 에뮬레이터 shell에서 명령어를 입력할 수 있도록 설정해주어야 한다.

 

 

 

설정한 deeplink의 scheme이 다른 앱과 겹치면

 

market이라는 이름의 scheme이 겹친 경우

 

 

 

위와 같이 딥링크가 일치하는 어플리케이션들 중에서 원하는 앱을 선택해야 하는 상황이 발생하기도 한다.

이러한 상황을 방지할 수 있는 방법은 딥링크의 일종인 앱링크를 사용하는 방법이 있다.

앱링크는 도메인 주소를 이용한 딥링크로, 위에서 다룬 스킴을 이용한 딥링크를 등록하는 것과 마찬가지로 AndroidMenifest에서 해당 activity에 intent-filter를 설정해주면 된다.

앱링크 외에도 유니버셜 링크가 있다.

하나의 딥링크만으로는 모든 환경에 대응하지 못하기 때문에 최적의 사용자 경험을 위해서는 3개의 딥링크 방식을 채택하여 상호 보완적으로 사용하는 것이 좋다.