C# MAUI - 안드로이드 "Share" 대상으로 등록하는 방법
가령, 안드로이드의 Youtube 앱에서 "Share" 버튼을 눌렀을 때 내가 만든 응용 프로그램이 목록에 나오고 싶을 경우가 있습니다.
이에 대해 찾아보면 그럴싸한 공식 문서가 나오는데요,
Learn / .NET / .NET MAUI - Share
; https://learn.microsoft.com/en-us/dotnet/maui/platform-integration/data/share?tabs=android
아쉽게도 저건, 앱에서 공유된 자원을 접근하는 방법을 설명합니다. 즉 Share에서 내 앱을 리스팅하는 내용이 아닙니다. 그래도 다행인 건, 이와 관련해 검색해 보면 IntentFilter와, ActivityAttribute.Exported = true 설정을 하면 된다는 글이 나옵니다.
using Android.App;
using Android.Content;
using Android.OS;
namespace MauiApp1.Platforms.Android;
[Activity(Exported = true)]
[IntentFilter(new[] { Intent.ActionSend },
Categories = [Intent.CategoryDefault], DataMimeType = "text/plain")]
internal class UrlShareActivity : Activity
{
protected override async void OnCreate(Bundle? savedInstanceState)
{
base.OnCreate(savedInstanceState);
if (this.Intent?.Action == Intent.Action && Intent.Type == "text/plain")
{
var data = Intent?.ClipData?.GetItemAt(0);
var text = data.Text; // 사용자가 공유한 URL
}
}
}
Activity를 상속했고 ActivityAttribute 특성을 지정했으니 아래의 문서에 나오듯이,
Android app manifest
; https://learn.microsoft.com/en-us/dotnet/maui/android/manifest
"\obj\Debug\net8.0-android\AndroidManifest.xml" 파일로 위의 UrlShareActivity 설정 하나가 (빌드 시) 자동으로 추가됩니다.
<activity android:exported="true" android:name="crc64e2862aff4a97f0b0.UrlShareActivity">
<intent-filter>
<action android:name="android.intent.action.SEND" />
<category android:name="android.intent.category.DEFAULT" />
<data android:mimeType="text/plain" />
</intent-filter>
</activity>
따라서, 이후 안드로이드 폰에서 Share 버튼을 누르면 앱 목록에 우리가 만든 앱이 함께 뜨게 됩니다.
그런데, 여기서 문제가 있습니다. ^^ 저렇게 UrlShareActivity를 통해 들어오면 이제 화면에는 그냥 빈 UI만 보인다는 점입니다. 이렇게!
대개의 경우, URL을 공유 받으면 원래의 App 화면에서 그 대응을 하게 될 것입니다. 그래서 다음과 같이 이동을 하고 싶을 텐데요,
await Shell.Current.GoToAsync("//MainPage");
동작을 하지 않습니다. ^^; 그러니까, 바로 이 문제를 지난번에 다룬 것입니다.
C# MAUI - 안드로이드 플랫폼에서의 Activity 제어
; https://www.sysnet.pe.kr/2/0/13634
따라서 1) Intent 전환을 통해 MainActivity로 넘어오거나, 2) UrlShareActivity에서 안드로이드 axml UI 방식을 따라 제어를 하거나, 3) 아니면 애당초 MainActivity 자체를 Exported 대상으로 설정하는 방법을 택해야 합니다. 이번 글에서는, 1번 방법인 MainActivity로 전환하는 것을 가정하고 설명하겠습니다.
자, 그럼 Share 이후에 Intent 전환으로 (MainPage XAML을 소유한) MainActivity까지 뜨게 되었습니다. 이제 Share로 넘어온 정보를 MainActivity에서 취해야 하는데요, 이를 위해서는 UrlShareActivity 측에서 Intent를 넘길 때부터 공유 받은 그 정보를 먼저 넘겨야 합니다.
[Activity(Exported = true)]
[IntentFilter(new[] { Intent.ActionSend }, Categories = [Intent.CategoryDefault], DataMimeType = "text/plain")]
internal class UrlShareActivity : Activity
{
protected override void OnCreate(Bundle? savedInstanceState)
{
base.OnCreate(savedInstanceState);
if (this.Intent == null)
{
return;
}
Intent intent = this.Intent;
if (intent.Action == Intent.ActionSend && intent.Type == "text/plain")
{
var data = intent.ClipData?.GetItemAt(0);
var text = data?.Text;
if (string.IsNullOrEmpty(text))
{
return;
}
var mainIntent = new Intent(this, typeof(MainActivity));
mainIntent.SetAction(Intent.ActionSend);
mainIntent.SetType(intent.Type);
mainIntent.PutExtra("url", text);
StartActivity(mainIntent);
}
}
}
그리고 저걸 넘겨받는 MainActivity는, 정상적인 동작을 위해서는 LaunchMode를 LaunchMode.SingleTask로 했을 것이므로 OnCreate 또는 OnNewIntent가 발생합니다. 즉, 한 번도 실행한 적이 없거나 아니면 이미 종료 상태로 바뀌었다면 OnCreate가 발생하겠지만, 아직 이전 실행 상태가 지속 중이라면 OnNewIntent가 발생합니다.
따라서, MainActivity에서는 다음과 같은 식의 코드로 URL을 넘겨받을 수 있습니다.
// ...[생략]...
public class MainActivity : MauiAppCompatActivity
{
protected override void OnCreate(Bundle? savedInstanceState)
{
base.OnCreate(savedInstanceState);
OnShare(this.Intent);
}
protected override void OnNewIntent(Intent? intent)
{
base.OnNewIntent(intent);
OnShare(intent);
}
void OnShare(Intent? intent)
{
if (intent == null)
{
return;
}
if (intent.Action == Intent.ActionSend && intent.Type == "text/plain")
{
var text = intent.GetStringExtra("url");
if (string.IsNullOrEmpty(text))
{
return;
}
}
}
// ...[생략]...
}
일단, 여기까지는 Android 플랫폼의 특성에 따른 Share 문제를 해결합니다.
자, 이제 남은 문제는, 저렇게 구한 text 정보를 어떻게 (.NET MAUI의 다중 플랫폼 환경인) MainPage로 넘기느냐입니다. 이것도 결국 Activity에서 Shell.Current.GoToAsync와 같은 메서드가 실행되지 않는 문제와 유사합니다. 즉, UI Page에 공식적으로 정보를 전달할 방법이 없습니다.
사실 개인적으로, Activity에서 UI Page를 연동할 방법이 없다는 것이 좀 이해가 안 됩니다. (MAUI 생초보자인 제가 모르는 걸 수도 있습니다. 혹시, 방법을 알고 계신 분은 덧글 부탁드립니다. ^^) 아마도 XAML 환경은 다중 플랫폼을 고려한 것이기 때문에 플랫폼 의존적인 부분과의 연동을 감춘 것이 아닌가... 라고 예상만 할 뿐입니다.
암튼, 이렇게 된 이상 (In 또는) Inter Process Communication을 쓰거나 기타 어떤 식으로든 정보를 전달할 수단을 찾아야 합니다. 그나마 가장 편한 것이, CommunityToolkit.Mvvm에 있는 Messenger가 아닐까 싶은데요,
.NET Maui pass data from MainActivity.cs to a view model in order to display it
; https://stackoverflow.com/questions/77346428/net-maui-pass-data-from-mainactivity-cs-to-a-view-model-in-order-to-display-it
Messaging Made Easy: A Guide to WeakReferenceMessenger in .NET MAUI
; https://cedricgabrang.medium.com/messaging-made-easy-a-guide-to-weakreferencemessenger-in-net-maui-dc0d131163c
그래서 우선 패키지 참조를 추가하고,
Install-Package CommunityToolkit.Mvvm
MainPage에서는 메시지 구독을 하고,
// ...[생략]...
public partial class MainPage : ContentPage
{
public MainPage()
{
InitializeComponent();
WeakReferenceMessenger.Default.Register<UrlShareMessage>(this, (r, m) =>
{
var urlText = m.Value;
this.Title = urlText; // Title에 공유 받은 텍스트를 설정
});
}
// ...[생략]...
}
public class UrlShareMessage : ValueChangedMessage<string>
{
public UrlShareMessage(string value) : base(value)
{
}
}
MainActivity에서는 메시지 발생을 하면 됩니다.
// ...[생략]...
public class MainActivity : MauiAppCompatActivity
{
// ...[생략]...
void OnShare(Intent? intent)(Intent? intent)
{
if (intent == null)
{
return;
}
if (intent.Action == Intent.ActionSend && intent.Type == "text/plain")
{
var text = intent.GetStringExtra("url");
if (string.IsNullOrEmpty(text))
{
return;
}
WeakReferenceMessenger.Default.Send(new UrlShareMessage(text));
}
}
}
자, 이제 Youtube를 실행하고 "Share" 버튼을 눌러 URL을 공유하면 정상적으로 우리가 만든 App의 Title이 바뀌는 것을 볼 수 있습니다. ^^
[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]