자습서: Notification Hubs를 사용하여 Xamarin.Android 앱에 푸시 알림 보내기

아티클
02/08/2024

개요

참고 항목

Firebase Cloud Messaging 사용 중단 및 마이그레이션 단계에 대한 자세한 내용은 Google Firebase Cloud Messaging 마이그레이션을 참조 하세요.

이 자습서에서는 Azure Notification Hubs를 사용하여 Xamarin.Android 애플리케이션에 푸시 알림을 보내는 방법을 보여 줍니다. FCM(Firebase Cloud Messaging)을 사용하여 푸시 알림을 받는 빈 Xamarin.Android 앱을 만듭니다. 알림 허브를 사용하여 앱을 실행하는 모든 디바이스에 푸시 알림을 브로드캐스트합니다. 완성된 코드는 NotificationHubs 앱 샘플에서 사용할 수 있습니다.

이 자습서에서 수행하는 단계는 다음과 같습니다.

Firebase 프로젝트 만들기 및 Firebase Cloud Messaging 사용
알림 허브 만들기
Xamarin.Android 앱 만들기 및 알림 허브에 연결
Azure Portal에서 테스트 알림 보내기

필수 조건

Azure 구독. Azure 구독이 아직 없는 경우 시작하기 전에 Azure 체험 계정을 만듭니다.
Windows에서 Xamarin이 있는 Visual Studio 또는 OS X의 Mac용 Visual Studio.
활성 Google 계정

Firebase 프로젝트 만들기 및 Firebase Cloud Messaging 사용

Firebase 콘솔에 로그인합니다. 아직 없는 경우 새 Firebase 프로젝트를 만듭니다.
프로젝트를 만든 후 Android 앱에 Firebase 추가를 선택합니다.
Android 앱에 Firebase 추가 페이지에서 다음 단계를 수행합니다.
1. Android 패키지 이름에 패키지 이름을 입력합니다. 예: tutorials.tutoria1.xamarinfcmapp
2. 앱 등록을 선택합니다.
3. google-services.json 다운로드를 선택합니다. 그런 다음, 파일을 프로젝트의 폴더에 저장하고 다음을 선택합니다. Visual Studio 프로젝트를 아직 만들지 않은 경우 프로젝트를 만든 후 이 단계를 수행할 수 있습니다.
4. 다음을 선택합니다.
5. 이 단계 건너뛰기 선택
Firebase 콘솔에서 프로젝트에 대한 톱을 선택합니다. 그런 다음 프로젝트 설정 선택합니다.
google-services.json 파일을 다운로드하지 않은 경우 이 페이지에서 다운로드할 수 있습니다.
맨 위에 있는 클라우드 메시징 탭으로 전환합니다. 나중에 사용할 수 있는 서버 키를 복사하고 저장합니다. 이 값을 사용하여 알림 허브를 구성합니다.

알림 허브 만들기

Azure Portal에 로그인합니다.
왼쪽 메뉴에서 모든 서비스를 선택합니다.
필터 서비스 텍스트 상자에 Notification Hubs 를 입력합니다. 서비스 이름 옆의 별표 아이콘을 선택하여 서비스를 왼쪽 메뉴의 즐겨찾기 섹션에 추가합니다. Notification Hubs를 선택합니다.
Notification Hubs 페이지의 도구 모음에서 만들기를 선택합니다.
알림 허브 페이지의 기본 사항 탭에서 다음 단계를 수행합니다.
1. 구독에서 사용하려는 Azure 구독 이름을 선택한 다음, 기존 리소스 그룹을 선택하거나 새 리소스 그룹을 만듭니다.
2. 네임스페이스 세부 정보에 새 네임스페이스의 고유한 이름을 입력합니다.
3. 네임스페이스에 알림 허브가 하나 이상 포함되어 있으므로 Notification Hub 세부 정보에 허브 이름을 입력합니다.
4. 위치 드롭다운 목록 상자에서 값을 선택합니다. 이 값은 허브를 만들려는 위치를 지정합니다.
5. 가용성 영역 옵션을 검토합니다. 가용성 영역이 있는 지역을 선택한 경우 기본적으로 검사 상자가 선택됩니다. 가용성 영역 유료 기능이므로 계층에 추가 요금이 추가됩니다.
6. 재해 복구 옵션( 없음, 쌍을 이루는 복구 지역 또는 유연한 복구 지역)을 선택합니다. 쌍을 이루는 복구 지역을 선택하면 장애 조치(failover) 지역이 표시됩니다. 유연한 복구 지역을 선택한 경우 드롭다운을 사용하여 복구 지역 목록에서 선택합니다.
7. 만들기를 실행합니다.
배포가 완료되면 리소스로 이동을 선택합니다.

알림 허브에 대한 GCM/FCM 설정 구성

왼쪽 메뉴의 설정 섹션에서 Google(GCM/FCM)을 선택합니다.
Google Firebase 콘솔에서 적어 두는 서버 키를 입력합니다.
도구 모음에서 저장을 선택합니다.

알림 허브가 FCM과 작동하도록 구성되었으며, 알림을 받고 푸시 알림을 보내기 위해 앱을 등록하는 연결 문자열이 있습니다.

Xamarin.Android 앱 만들기 및 알림 허브에 연결

Visual Studio 프로젝트 만들기 및 NuGet 패키지 추가

참고 항목

이 자습서에 설명된 단계는 Visual Studio 2017용입니다.

Visual Studio에서 파일 메뉴를 열고 새로 만들기를 선택한 다음 프로젝트를 선택합니다. 새 프로젝트 창에서 다음 단계를 수행합니다.
1. 설치된 Visual C#을 확장한 다음 Android를 클릭합니다.
2. 목록에서 Android 앱(Xamarin)을 선택합니다.
3. 프로젝트의 이름 을 입력합니다.
4. 프로젝트의 위치 를 선택합니다.
5. 확인을 선택합니다.
새 Android 앱 대화 상자에서 빈 앱을 선택하고 확인을 선택합니다.
솔루션 탐색기 창에서 속성을 확장하고 AndroidManifest.xml 클릭합니다. Google Firebase 콘솔에서 프로젝트에 Firebase Cloud Messaging을 추가할 때 입력한 패키지 이름과 일치하도록 패키지 이름을 업데이트합니다.
다음 단계에 따라 프로젝트의 대상 Android 버전을 Android 10.0 으로 설정합니다.
1. 프로젝트를 마우스 오른쪽 단추로 클릭하고 속성을 선택합니다.
2. Android 버전을 사용한 컴파일: (대상 프레임워크) 필드의 경우 Android 10.0을 선택합니다.
3. 메시지 상자에서 예를 선택하여 대상 프레임워크를 계속 변경합니다.
다음 단계에 따라 필요한 NuGet 패키지를 프로젝트에 추가합니다.
1. 프로젝트를 마우스 오른쪽 단추로 클릭하고 NuGet 패키지 관리를 선택합니다.
2. 설치된 탭으로 전환하고, Xamarin.Android.Support.Design 선택하고, 오른쪽 창에서 업데이트를 선택하여 패키지를 최신 버전으로 업데이트합니다.
3. 찾아보기 탭으로 전환합니다. Xamarin.GooglePlayServices.Base를 검색 합니다. 결과 목록에서 Xamarin.GooglePlayServices.Base를 선택합니다. 그런 후 설치를 선택합니다.
4. NuGet 패키지 관리자 창에서 Xamarin.Firebase.Messaging을 검색합니다. 결과 목록에서 Xamarin.Firebase.Messaging을 선택합니다. 그런 후 설치를 선택합니다.
5. 이제 Xamarin.Azure.NotificationHubs.Android를 검색합니다. 결과 목록에서 Xamarin.Azure.NotificationHubs.Android를 선택합니다. 그런 후 설치를 선택합니다.

Google Services JSON 파일 추가

google-services.json Google Firebase 콘솔에서 다운로드한 파일을 프로젝트 폴더로 복사합니다.
프로젝트에 google-services.json을(를) 추가합니다.
솔루션 탐색기 창에서 google-services.json을 선택합니다.
속성 창에서 빌드 작업을 GoogleServicesJson으로 설정합니다. GoogleServicesJson이 표시되지 않으면 Visual Studio를 닫고 다시 시작하고 프로젝트를 다시 열고 다시 시도합니다.

프로젝트에서 알림 허브 설정

Firebase Cloud Messaging에 등록

Google Cloud Messaging에서 Firebase로 마이그레이션하는 경우 프로젝트의 AndroidManifest.xml 파일에 오래된 GCM 구성이 포함될 수 있으며 이로 인해 알림이 중복될 수 있습니다. 파일을 편집하고 섹션 내에서 <application> 다음 줄을 제거합니다(있는 경우).

<receiver
    android:name="com.google.firebase.iid.FirebaseInstanceIdInternalReceiver"
    android:exported="false" />
<receiver
    android:name="com.google.firebase.iid.FirebaseInstanceIdReceiver"
    android:exported="true"
    android:permission="com.google.android.c2dm.permission.SEND">
    <intent-filter>
        <action android:name="com.google.android.c2dm.intent.RECEIVE" />
        <action android:name="com.google.android.c2dm.intent.REGISTRATION" />
        <category android:name="${applicationId}" />
    </intent-filter>
</receiver>

애플리케이션 요소 앞에 다음 문을 추가합니다.

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="com.google.android.c2dm.permission.RECEIVE" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.GET_ACCOUNTS"/>

Android 앱 및 알림 허브에 대해 다음 정보를 수집합니다.
- 연결 문자열 수신 대기: Azure Portal의 대시보드에서 연결 문자열 보기를 선택합니다. 이 값에 DefaultListenSharedAccessSignature 대한 연결 문자열 복사합니다.
- 허브 이름: Azure Portal의 허브 이름입니다. 예를 들어 mynotificationhub2입니다.
솔루션 탐색기 창에서 프로젝트를 마우스 오른쪽 단추로 클릭하고 추가를 선택한 다음, 클래스를 선택합니다.

Constants.cs Xamarin 프로젝트에 대한 클래스를 만들고 클래스에서 다음 상수 값을 정의합니다. 자리 표시자를 값으로 바꿉 있습니다.

public static class Constants
{
    public const string ListenConnectionString = "<Listen connection string>";
    public const string NotificationHubName = "<hub name>";
}

명령문을 사용하여 다음 항목을 MainActivity.cs에 추가합니다.
```
using WindowsAzure.Messaging.NotificationHubs;
```

다음 속성을 MainActivity 클래스에 추가합니다.

internal static readonly string CHANNEL_ID = "my_notification_channel";

에서 MainActivity.cs다음에 다음 코드를 OnCreate 추가합니다.base.OnCreate(savedInstanceState)

// Listen for push notifications
NotificationHub.SetListener(new AzureListener());

// Start the SDK
NotificationHub.Start(this.Application, HubName, ConnectionString);

프로젝트에 명명된 AzureListener 클래스를 추가합니다.

다음 using 문을 .에 AzureListener.cs추가합니다.

using Android.Content;
using WindowsAzure.Messaging.NotificationHubs;

클래스 선언 위에 다음을 추가하고 클래스에서 상속 Java.Lang.Object 하고 다음을 INotificationListener구현하게 합니다.
```
public class AzureListener : Java.Lang.Object, INotificationListener
```

수신된 메시지를 처리하려면 클래스 내에 AzureListener 다음 코드를 추가합니다.

    public void OnPushNotificationReceived(Context context, INotificationMessage message)
    {
        var intent = new Intent(this, typeof(MainActivity));
        intent.AddFlags(ActivityFlags.ClearTop);
        var pendingIntent = PendingIntent.GetActivity(this, 0, intent, PendingIntentFlags.OneShot);

        var notificationBuilder = new NotificationCompat.Builder(this, MainActivity.CHANNEL_ID);

        notificationBuilder.SetContentTitle(message.Title)
                    .SetSmallIcon(Resource.Drawable.ic_launcher)
                    .SetContentText(message.Body)
                    .SetAutoCancel(true)
                    .SetShowWhen(false)
                    .SetContentIntent(pendingIntent);

        var notificationManager = NotificationManager.FromContext(this);

        notificationManager.Notify(0, notificationBuilder.Build());
    }

프로젝트를 빌드 합니다.
디바이스 또는 로드된 에뮬레이터에서 앱 실행

Azure Portal에서 테스트 알림 전송

Azure Portal에서 테스트 보내기 옵션을 사용하여 앱에서 알림 수신을 테스트할 수 있습니다. 디바이스에 테스트 푸시 알림을 보냅니다.

Azure portal - Test Send

푸시 알림은 일반적으로 Mobile Services 또는 ASP.NET과 같은 백 엔드 서비스에서 호환되는 라이브러리를 통해 보내집니다. 백 엔드에 라이브러리를 사용할 수 없는 경우 REST API를 직접 사용하여 알림 메시지를 보낼 수도 있습니다.

다음 단계

이 자습서에서는 백 엔드에 등록된 모든 Android 디바이스에 브로드캐스트 알림을 보냈습니다. 특정 Android 디바이스에 알림을 푸시하는 방법을 알아보려면 다음 자습서로 진행합니다.

특정 디바이스에 알림 푸시