Xamarin.Forms 앱에 푸시 알림 추가

개요

이 자습서에서는 Xamarin.Forms 빠른 시작에서 생성된 모든 프로젝트에 푸시 알림을 추가합니다. 즉, 레코드가 삽입될 때마다 모든 플랫폼 간 클라이언트에 푸시 알림이 전송됩니다.

다운로드한 빠른 시작 서버 프로젝트를 사용하지 않는 경우 푸시 알림 확장 패키지가 필요합니다. 자세한 내용은 Azure Mobile Apps의 .NET 백엔드 서버 SDK와 작업하기를 참고하세요.

필수 조건

iOS의 경우 Apple Developer Program 회원 자격 및 물리적 iOS 디바이스가 필요합니다. iOS 시뮬레이터는 푸시 알림지원하지 않습니다.

알림 허브 구성

Azure App Service의 Mobile Apps 기능은 Azure Notification Hubs 사용하여 푸시를 보내므로 모바일 앱에 대한 알림 허브를 구성합니다.

Azure 포털에서 App Services로 이동한 다음, 앱 백엔드를 선택합니다. 설정에서, 푸시를선택합니다.
앱에 알림 허브 리소스를 추가하려면 연결선택합니다. 허브를 만들거나 기존 허브에 연결할 수 있습니다.

이제 Mobile Apps 백 엔드 프로젝트에 알림 허브를 연결했습니다. 나중에 디바이스에 푸시할 PNS(플랫폼 알림 시스템)에 연결하도록 이 알림 허브를 구성합니다.

푸시 알림을 보내도록 서버 프로젝트 업데이트

이 섹션에서는 새 항목이 추가 될 때마다 푸시 알림을 보내도록 기존 Mobile Apps 백 엔드 프로젝트의 코드를 업데이트합니다. 이 프로세스는 플랫폼 간 푸시를 가능하게 하는 Azure Notification Hubs의 템플릿 기능을 통해 제공됩니다. 다양한 클라이언트는 템플릿을 사용하여 푸시 알림에 등록되며 단일 유니버설 푸시는 모든 클라이언트 플랫폼에 연결할 수 있습니다.

백 엔드 프로젝트 형식과 일치하는 다음 절차 중 하나를 선택하세요: .NET 백 엔드 또는 백 엔드 Node.js.

.NET 백 엔드 프로젝트

Visual Studio에서 서버 프로젝트를 마우스 오른쪽 단추로 클릭합니다. 그런 다음 NuGet 패키지 관리선택합니다. Microsoft.Azure.NotificationHubs검색한 다음 설치 선택합니다. 이 프로세스는 백 엔드에서 알림을 보내기 위한 Notification Hubs 라이브러리를 설치합니다.
서버 프로젝트에서 컨트롤러>TodoItemController.cs엽니다. 그런 후 아래의 using 구문을 추가합니다.
```
using System.Collections.Generic;
using Microsoft.Azure.NotificationHubs;
using Microsoft.Azure.Mobile.Server.Config;
```

PostTodoItem 메서드에서 InsertAsync호출 후 다음 코드를 추가합니다.

// Get the settings for the server project.
HttpConfiguration config = this.Configuration;
MobileAppSettingsDictionary settings =
    this.Configuration.GetMobileAppSettingsProvider().GetMobileAppSettings();

// Get the Notification Hubs credentials for the mobile app.
string notificationHubName = settings.NotificationHubName;
string notificationHubConnection = settings
    .Connections[MobileAppSettingsKeys.NotificationHubConnectionString].ConnectionString;

// Create a new Notification Hub client.
NotificationHubClient hub = NotificationHubClient
.CreateClientFromConnectionString(notificationHubConnection, notificationHubName);

// Send the message so that all template registrations that contain "messageParam"
// receive the notifications. This includes APNS, GCM, WNS, and MPNS template registrations.
Dictionary<string,string> templateParams = new Dictionary<string,string>();
templateParams["messageParam"] = item.Text + " was added to the list.";

try
{
    // Send the push notification and log the results.
    var result = await hub.SendTemplateNotificationAsync(templateParams);

    // Write the success result to the logs.
    config.Services.GetTraceWriter().Info(result.State.ToString());
}
catch (System.Exception ex)
{
    // Write the failure result to the logs.
    config.Services.GetTraceWriter()
        .Error(ex.Message, null, "Push.SendAsync Error");
}

이 프로세스는 항목이 포함된 템플릿 알림을 보냅니다. 새 항목이 삽입될 때의 텍스트입니다.

서버 프로젝트를 다시 게시합니다.

Node.js 백 엔드 프로젝트

백 엔드 프로젝트를 설정합니다.

todoitem.js 기존 코드를 다음 코드로 바꿉다.

var azureMobileApps = require('azure-mobile-apps'),
promises = require('azure-mobile-apps/src/utilities/promises'),
logger = require('azure-mobile-apps/src/logger');

var table = azureMobileApps.table();

table.insert(function (context) {
// For more information about the Notification Hubs JavaScript SDK,
// see https://aka.ms/nodejshubs.
logger.info('Running TodoItem.insert');

// Define the template payload.
var payload = '{"messageParam": "' + context.item.text + '" }';  

// Execute the insert. The insert returns the results as a promise.
// Do the push as a post-execute action within the promise flow.
return context.execute()
    .then(function (results) {
        // Only do the push if configured.
        if (context.push) {
            // Send a template notification.
            context.push.send(null, payload, function (error) {
                if (error) {
                    logger.error('Error while sending push notification: ', error);
                } else {
                    logger.info('Push notification sent successfully!');
                }
            });
        }
        // Don't forget to return the results from the context.execute().
        return results;
    })
    .catch(function (error) {
        logger.error('Error while running context.execute: ', error);
    });
});

module.exports = table;

이 프로세스는 새 항목이 삽입될 때 item.text가 포함된 템플릿 알림을 보냅니다.

로컬 컴퓨터에서 파일을 편집할 때 서버 프로젝트를 다시 게시합니다.

Android 프로젝트 구성 및 실행(선택 사항)

Android용 Xamarin.Forms Droid 프로젝트에 푸시 알림을 사용하도록 설정하려면 이 섹션을 완료합니다.

FCM(Firebase Cloud Messaging) 사용

Firebase 콘솔에 로그인합니다. 아직 없는 경우 새 Firebase 프로젝트를 만듭니다.
프로젝트를 만든 후 Android 앱에 Firebase 추가를 선택합니다.
Android 앱에 Firebase 추가 페이지에서 다음 단계를 수행합니다.
1. Android 패키지 이름에서 애플리케이션의 build.gradle 파일에 있는 applicationId 값을 복사합니다. 이 예제에서는 com.fabrikam.fcmtutorial1app.
2. 앱 등록을 선택합니다.
google-services.json 다운로드를 선택하고 프로젝트의 app 폴더에 파일을 저장한 후 다음을 선택합니다.
Android Studio의 프로젝트에서 다음과 같은 구성 변경 작업을 수행합니다.
1. project-level build.gradle 파일(<project>/build.gradle)에서 dependencies 섹션에 다음 명령문을 추가합니다.
```
classpath 'com.google.gms:google-services:4.0.1'
```
2. app-level build.gradle 파일(<project>/<app-module>/build.gradle)에서 dependencies 섹션에 다음 명령문을 추가합니다.
```
implementation 'com.google.firebase:firebase-core:16.0.8'
implementation 'com.google.firebase:firebase-messaging:17.3.4'
```
3. app-level build.gradle 파일 끝부분에서 dependencies 섹션 다음에 다음 줄을 추가합니다.
```
apply plugin: 'com.google.gms.google-services'
```
4. 도구 모음에서 지금 동기화를 선택합니다.
다음을 선택합니다.
이 단계 건너뛰기를 선택합니다.
Firebase 콘솔에서 프로젝트의 톱니바퀴를 선택합니다. 그런 후 프로젝트 설정을 선택합니다.
Android Studio 프로젝트의 app 폴더에 google-services.json 파일을 다운로드하지 않은 경우 이 페이지에서 다운로드할 수 있습니다.
맨 위에 있는 클라우드 메시징 탭으로 전환합니다.
나중에 사용하기 위해 서버 키를 복사하고 저장합니다. 이 값을 사용하여 허브를 구성합니다.

FCM을 사용하여 푸시 요청을 보내도록 Mobile Apps 백 엔드 구성

Azure Portal모든>App Services찾아보기를 선택합니다. 그런 다음 Mobile Apps 백 엔드를 선택합니다.
설정에서, 푸시를선택합니다. 그런 다음 푸시 알림 서비스구성을 선택합니다.
Google(GCM)으로 이동합니다. Firebase 콘솔에서 가져온 FCM 레거시 서버 키를 입력한 다음 저장을 선택합니다.

이제 서비스가 Firebase Cloud Messaging과 작동하도록 구성되었습니다.

Android 프로젝트에 푸시 알림 추가

FCM으로 구성된 백 엔드를 사용하여 클라이언트에 구성 요소 및 코드를 추가하여 FCM에 등록할 수 있습니다. Mobile Apps 백 엔드를 통해 Azure Notification Hubs에 푸시 알림을 등록하고 알림을 받을 수도 있습니다.

Droid 프로젝트에서 참조를 마우스 오른쪽 단추로 클릭하여 NuGet 패키지 관리 ... >.
NuGet 패키지 관리자 창에서 Xamarin.Firebase.Messaging 패키지를 검색하여 프로젝트에 추가합니다.
Droid 프로젝트의 프로젝트 속성에서 Android 버전 7.0 이상을 사용하여 컴파일하도록 앱을 설정합니다.
Firebase 콘솔에서 다운로드한 google-services.json 파일을 Droid 프로젝트의 루트에 추가하고 빌드 작업을 GoogleServicesJson 설정합니다. 자세한 내용은 Google Services JSON 파일 추가을 참조하세요.

Firebase Cloud Messaging에 등록하기

AndroidManifest.xml 파일을 열고 다음 <receiver> 요소를 <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>

Firebase 인스턴스 ID 서비스 구현

Droid 프로젝트에 FirebaseRegistrationService새 클래스를 추가하고 다음 using 문이 파일 맨 위에 있는지 확인합니다.
```
using System.Threading.Tasks;
using Android.App;
using Android.Util;
using Firebase.Iid;
using Microsoft.WindowsAzure.MobileServices;
```
빈 FirebaseRegistrationService 클래스를 다음 코드로 바꿉다.
```
[Service]
[IntentFilter(new[] { "com.google.firebase.INSTANCE_ID_EVENT" })]
public class FirebaseRegistrationService : FirebaseInstanceIdService
{
    const string TAG = "FirebaseRegistrationService";

    public override void OnTokenRefresh()
    {
        var refreshedToken = FirebaseInstanceId.Instance.Token;
        Log.Debug(TAG, "Refreshed token: " + refreshedToken);
        SendRegistrationTokenToAzureNotificationHub(refreshedToken);
    }

    void SendRegistrationTokenToAzureNotificationHub(string token)
    {
        // Update notification hub registration
        Task.Run(async () =>
        {
            await AzureNotificationHubService.RegisterAsync(TodoItemManager.DefaultManager.CurrentClient.GetPush(), token);
        });
    }
}
```
FirebaseRegistrationService 클래스는 애플리케이션이 FCM에 액세스할 수 있도록 권한을 부여하는 보안 토큰을 생성합니다. OnTokenRefresh 메서드는 애플리케이션이 FCM에서 등록 토큰을 받을 때 호출됩니다. 메서드는 fcM에서 비동기적으로 업데이트되는 FirebaseInstanceId.Instance.Token 속성에서 토큰을 검색합니다. OnTokenRefresh 메서드는 애플리케이션이 설치되거나 제거될 때만 업데이트되거나, 사용자가 애플리케이션 데이터를 삭제할 때, 애플리케이션이 인스턴스 ID를 지울 때 또는 토큰의 보안이 손상된 경우에만 토큰이 업데이트되기 때문에 자주 호출되지 않습니다. 또한 FCM 인스턴스 ID 서비스는 애플리케이션이 주기적으로 토큰을 새로 고치도록 요청합니다(일반적으로 6개월마다).

또한 OnTokenRefresh 메서드는 사용자의 등록 토큰을 Azure Notification Hub와 연결하는 데 사용되는 SendRegistrationTokenToAzureNotificationHub 메서드를 호출합니다.

Azure Notification Hub에 등록

Droid 프로젝트에 AzureNotificationHubService새 클래스를 추가하고 다음 using 문이 파일 맨 위에 있는지 확인합니다.
```
using System;
using System.Threading.Tasks;
using Android.Util;
using Microsoft.WindowsAzure.MobileServices;
using Newtonsoft.Json.Linq;
```

빈 AzureNotificationHubService 클래스를 다음 코드로 바꿉다.

public class AzureNotificationHubService
{
    const string TAG = "AzureNotificationHubService";

    public static async Task RegisterAsync(Push push, string token)
    {
        try
        {
            const string templateBody = "{\"data\":{\"message\":\"$(messageParam)\"}}";
            JObject templates = new JObject();
            templates["genericMessage"] = new JObject
            {
                {"body", templateBody}
            };

            await push.RegisterAsync(token, templates);
            Log.Info("Push Installation Id: ", push.InstallationId.ToString());
        }
        catch (Exception ex)
        {
            Log.Error(TAG, "Could not register with Notification Hub: " + ex.Message);
        }
    }
}

RegisterAsync 메서드는 간단한 알림 메시지 템플릿을 JSON으로 만들고 Firebase 등록 토큰을 사용하여 알림 허브에서 템플릿 알림을 수신하도록 등록합니다. 이렇게 하면 Azure Notification Hub에서 보낸 모든 알림이 등록 토큰으로 표시되는 디바이스를 대상으로 합니다.

푸시 알림의 내용 표시

Droid 프로젝트에 FirebaseNotificationService새 클래스를 추가하고 다음 using 문이 파일 맨 위에 있는지 확인합니다.

using Android.App;
using Android.Content;
using Android.Media;
using Android.Support.V7.App;
using Android.Util;
using Firebase.Messaging;

빈 FirebaseNotificationService 클래스를 다음 코드로 바꿉다.

[Service]
[IntentFilter(new[] { "com.google.firebase.MESSAGING_EVENT" })]
public class FirebaseNotificationService : FirebaseMessagingService
{
    const string TAG = "FirebaseNotificationService";

    public override void OnMessageReceived(RemoteMessage message)
    {
        Log.Debug(TAG, "From: " + message.From);

        // Pull message body out of the template
        var messageBody = message.Data["message"];
        if (string.IsNullOrWhiteSpace(messageBody))
            return;

        Log.Debug(TAG, "Notification message body: " + messageBody);
        SendNotification(messageBody);
    }

    void SendNotification(string messageBody)
    {
        var intent = new Intent(this, typeof(MainActivity));
        intent.AddFlags(ActivityFlags.ClearTop);
        //Unique request code to avoid PendingIntent collision.
        var requestCode = new Random().Next();
        var pendingIntent = PendingIntent.GetActivity(this, requestCode, intent, PendingIntentFlags.OneShot);
        var notificationBuilder = new NotificationCompat.Builder(this)
            .SetSmallIcon(Resource.Drawable.ic_stat_ic_notification)
            .SetContentTitle("New Todo Item")
            .SetContentText(messageBody)
            .SetContentIntent(pendingIntent)
            .SetSound(RingtoneManager.GetDefaultUri(RingtoneType.Notification))
            .SetAutoCancel(true);

        var notificationManager = NotificationManager.FromContext(this);
        notificationManager.Notify(0, notificationBuilder.Build());
    }
}

애플리케이션이 FCM에서 알림을 받을 때 호출되는 OnMessageReceived 메서드는 메시지 콘텐츠를 추출하고 SendNotification 메서드를 호출합니다. 이 메서드는 알림 영역에 알림이 표시되어 애플리케이션이 실행되는 동안 시작된 로컬 알림으로 메시지 콘텐츠를 변환합니다.

이제 Android 디바이스 또는 에뮬레이터에서 실행되는 앱에서 푸시 알림을 테스트할 준비가 되었습니다.

Android 앱에서 푸시 알림 테스트

처음 두 단계는 에뮬레이터에서 테스트하는 경우에만 필요합니다.

Google Play 서비스로 구성된 디바이스 또는 에뮬레이터에 배포하거나 디버깅하고 있는지 확인합니다. Play 앱이 디바이스 또는 에뮬레이터에 설치되어 있는지 확인하여 확인할 수 있습니다.
앱>설정>계정추가를 클릭하여 Google 계정을 Android 디바이스에 추가합니다. 그런 다음 프롬프트에 따라 기존 Google 계정을 디바이스에 추가하거나 새 Google 계정을 만듭니다.
Visual Studio 또는 Xamarin Studio에서 Droid 프로젝트를 마우스 오른쪽 단추로 클릭하고 시작 프로젝트로 설정을 클릭합니다.
실행 클릭하여 프로젝트를 빌드하고 Android 디바이스 또는 에뮬레이터에서 앱을 시작합니다.
앱에서 작업을 입력한 다음 더하기(+) 아이콘을 클릭합니다.
항목이 추가될 때 알림이 수신되는지 확인합니다.

iOS 프로젝트 구성 및 실행(선택 사항)

이 섹션은 iOS 디바이스용 Xamarin iOS 프로젝트를 실행하기 위한 것입니다. iOS 디바이스를 사용하지 않는 경우 이 섹션을 건너뛸 수 있습니다.

인증서 서명 요청 파일 생성

APN(Apple Push Notification Service)은 인증서를 사용하여 푸시 알림을 인증합니다. 알림을 보내고 받는 데 필요한 푸시 인증서를 만들려면 다음 지침을 따르세요. 이러한 개념에 대한 자세한 내용은 Apple Push Notification Service 공식 설명서를 참조하세요.

Apple에서 서명된 푸시 인증서를 생성하는 데 사용하는 CSR(인증서 서명 요청) 파일을 생성합니다.

Mac에서 Keychain Access 도구를 실행합니다. 실행 패드의 Utilities 폴더 또는 Other 폴더에서 열 수 있습니다.
Keychain 액세스를 선택하고, 인증서 도우미를 확장한 다음, 인증 기관에서 인증서 요청을 선택합니다.

요청

비고

기본적으로 Keychain Access는 목록의 첫 번째 항목을 선택합니다. 이는 사용자가 인증서 카테고리에 있고, Apple Worldwide Developer Relations Certification Authority가 목록의 첫 번째 항목이 아닌 경우 문제가 될 수 있습니다. CSR(인증서 서명 요청)을 생성하기 전에 키가 아닌 항목이 있거나 Apple Worldwide Developer Relations Certification Authority 키가 선택되어 있는지 확인합니다.
사용자 이메일 주소를 선택하고, 일반 이름 값을 입력하고, 디스크에 저장됨을 지정했는지 확인한 다음, 계속을 선택합니다. CA 이메일 주소는 필요하지 않으므로 비워둡니다.
다른 이름으로 저장에 CSR 파일의 이름을 입력하고, 어디에서 위치를 선택한 다음, 저장을 선택합니다.

파일 이름 선택

이 작업은 CSR 파일을 선택한 위치에 저장합니다. 기본 위치는 바탕 화면입니다. 이 파일에 대해 선택한 위치를 기억해 두세요.

다음으로 Apple에 앱을 등록하고, 푸시 알림을 사용하도록 설정하고, 내보낸 CSR을 업로드하여 푸시 인증서를 만듭니다.

푸시 알림을 위해 앱 등록

푸시 알림을 iOS 앱에 보내려면 Apple에 애플리케이션을 등록하고 푸시 알림도 등록합니다.

앱을 아직 등록하지 않은 경우 Apple Developer Center에서 iOS Provisioning Portal로 이동합니다. Apple ID를 사용하여 포털에 로그인하고 Identifier(식별자)를 선택합니다. 그런 다음, +를 선택하여 새 앱을 등록합니다.
Register a New Identifier(새 식별자 등록) 화면에서 App ID(앱 ID) 라디오 단추를 선택합니다. 그런 다음 계속을 선택합니다.
새 앱에 다음과 같은 세 개의 값을 업데이트한 다음, 계속을 선택합니다.
- 설명: 앱에 대한 설명이 포함된 이름을 입력합니다.
- 번들 ID: 앱 배포 가이드에서 설명한 대로 Organization Identifier.Product Name 형식의 번들 ID를 입력합니다. 조직 식별자 및 제품 이름 값은 XCode 프로젝트를 만들 때 사용하는 조직 식별자 및 제품 이름과 일치해야 합니다. 다음 스크린샷에서는 조직 식별자로 NotificationHubs 값이 사용되고 제품 이름으로 GetStarted 값이 사용되었습니다. Xcode에서 올바른 게시 프로필을 사용하도록 번들 식별자 값이 Xcode 프로젝트의 값과 일치하는지 확인합니다.
- 푸시 알림: 기능 섹션에서 푸시 알림 옵션을 선택합니다.
  
  새 앱 IDForm to register a new App ID등록하기 위한양식
  
  이 작업은 앱 ID를 생성하고 사용자에게 정보 확인을 요청합니다. Continue(계속)를 선택한 다음, Register(등록)를 선택하여 새 앱 ID를 확인합니다.
  
  확인
  
  등록을 선택하면 새 앱 ID가 인증서, 식별자 & 프로필 페이지에 줄 항목으로 표시됩니다.
Certificates, Identifiers & Profiles(인증서, 식별자 및 프로필) 페이지의 Identifiers(식별자) 아래에서 방금 만든 앱 ID 줄 항목을 찾고, 해당 행을 선택하여 Edit your App ID Configuration(앱 ID 구성 편집) 화면을 표시합니다.

Notification Hubs에 대한 인증서 만들기

알림 허브가 APNS와 함께 작동하도록 설정하려면 인증서가 필요합니다. 이 작업은 다음 두 가지 방법 중 하나로 수행할 수 있습니다.

Notification Hub에 직접 업로드할 수 있는 .p12 만듭니다.
토큰 기반 인증 사용할 수 있는 .p8 만듭니다(최신 방법).

최신 방법은 APNS 대한토큰 기반(HTTP/2) 인증에 설명된 대로 인증서 사용과 비교하여 많은 이점을 제공합니다. 그러나 두 방법 모두에 대한 단계가 제공되었습니다.

옵션 1: Notification Hub에 직접 업로드할 수 있는 .p12 푸시 인증서 만들기

아래로 스크롤하여 선택한 Push Notifications(푸시 알림) 옵션으로 이동한 다음, Configure(구성)를 선택하여 인증서를 만듭니다.
Apple Push Notification service SSL Certificates(Apple 푸시 알림 서비스 SSL 인증서) 창이 표시됩니다. 개발 SSL 인증서 섹션에서 인증서 만들기 단추를 선택합니다.

Create a new Certificate(새 인증서 만들기) 화면이 표시됩니다.

비고

이 자습서에서는 개발 인증서를 사용합니다. 프로덕션 인증서를 등록할 때에도 동일한 프로세스가 사용됩니다. 알림을 보낼 때 동일한 인증서 유형을 사용해야 합니다.
파일선택하고 첫 번째 작업에서 CSR 파일을 저장한 위치로 이동한 다음 인증서 이름을 두 번 클릭하여 로드합니다. 그런 다음 계속을 선택합니다.
포털에서 인증서가 만들어지면 Download(다운로드) 단추를 선택합니다. 인증서를 저장하고 저장된 위치를 기억합니다.

인증서가 다운로드되어 Downloads 폴더에 컴퓨터에 저장됩니다.

인증서 파일 찾기

비고

기본적으로 다운로드된 개발 인증서는 이름이 aps_development.cer로 지정됩니다.
다운로드한 푸시 인증서 aps_development.cer을 두 번 클릭합니다. 이 작업은 다음 이미지와 같이 키 집합에 새 인증서를 설치합니다.

키체인 접근 인증서 목록 표시

비고

인증서의 이름은 다를 수 있지만 이름은 Apple Development iOS Push Services접두사로 지정됩니다.
Keychain Access에서는 인증서 범주에서 만든 새 푸시 인증서를 마우스 오른쪽 단추로 클릭합니다. 내보내기를 선택하고 파일의 이름을 지정한 다음 .p12 형식 및 저장을 선택합니다.

암호를 사용하여 인증서를 보호하도록 선택할 수 있지만 이는 선택 사항입니다. 암호 만들기를 무시하려면 OK(확인)를 클릭합니다. 내보낸 .p12 인증서의 파일 이름과 위치를 적어둡니다. APN으로 인증을 사용하도록 설정하는 데 사용됩니다.

비고

.p12 파일 이름과 위치가 이 자습서에 표시된 것과 다를 수 있습니다.

옵션 2: 토큰 기반 인증에 사용할 수 있는 .p8 인증서 만들기

다음 세부 사항에 유의합니다.
- 앱 ID 접두사(팀 ID)
- 번들 ID
인증서, 식별자 및 프로필로 돌아가서 키를 클릭합니다.

비고

APNS에 대해 구성된 키가 이미 있는 경우 만든 직후 바로 다운로드한 .p8 인증서를 다시 사용할 수 있습니다. 그렇다면 3부터 5까지 단계를 무시할 수 있습니다.
+ 단추(키 만들기 단추)를 클릭하여 새 키를 만듭니다.
적절한 키 이름 값을 입력한 다음 APN(Apple Push Notifications Service) 옵션을 선택한 다음 계속클릭한 다음 다음 화면에서 등록합니다.
다운로드 클릭한 다음 .p8 파일(AuthKey_접두사)을 보안 로컬 디렉터리로 이동한 다음 완료클릭합니다.

비고

.p8 파일을 안전한 장소에 보관하고 백업을 저장해야 합니다. 키를 다운로드한 후에는 서버 복사본이 제거되므로 다시 다운로드할 수 없습니다.
키에서 방금 만든 키(또는 대신 사용하도록 선택한 경우 기존 키)를 클릭합니다.
Key ID 값을 기록해 둡니다.
Visual Studio Code등 원하는 적합한 애플리케이션에서 .p8 인증서를 연 다음 키 값을 기록해 둡니다. 이는 -----BEGIN PRIVATE KEY----- 및 -----END PRIVATE KEY----- 사이의 값입니다.
```
-----BEGIN PRIVATE KEY-----
<key_value>
-----END PRIVATE KEY-----
```
비고

토큰 값은 나중에 Notification Hub를 구성하는 데 사용됩니다.

이 단계가 끝나면 나중에 APNs 정보로 알림 허브를 구성할 때 사용할 수 있는 다음 정보를 확보해야 합니다.

팀 ID(1단계 참조)
번들 ID(1단계 참조)
키 ID(7단계 참조)
토큰 값, 즉 .p8 키 값 (8단계 참조)

앱에 대한 프로비저닝 프로필 만들기

iOS Provisioning Portal로 돌아가서 Certificates, Identifiers & Profiles(인증서, 식별자 및 프로필)를 선택하고, 왼쪽 메뉴에서 Profiles(프로필)를 선택한 다음, +를 선택하여 새 프로필을 만듭니다. Register a New Provisioning Profile(새 프로비저닝 프로필 등록) 화면이 표시됩니다.
Development(개발) 아래에서 프로비저닝 프로필 유형으로 iOS App Development(iOS 앱 개발)를 선택한 다음, Continue(계속)를 선택합니다.
다음으로, 앱 ID 드롭다운 목록에서 생성한 “앱 ID”를 선택하고, 계속를 선택합니다.

선택
Select certificates(인증서 선택) 창에서 코드 서명에 사용하는 개발 인증서를 선택하고, Continue(계속)를 선택합니다. 이 인증서는 사용자가 만든 푸시 인증서가 아닙니다. 계정이 없으면 만들어야 합니다. 인증서가 있으면 다음 단계로 건너뜁니다. 개발 인증서가 없으면 해당 인증서를 만들기 위해 다음을 수행합니다.
1. No Certificates are available(사용할 수 있는 인증서가 없습니다)이 표시되면 Create Certificate(인증서 만들기)를 선택합니다.
2. Software(소프트웨어) 섹션에서 Apple Development(Apple 개발)를 선택합니다. 그런 다음 계속을 선택합니다.
3. Create a New Certificate(새 인증서 만들기) 화면에서 Choose File(파일 선택)을 선택합니다.
4. 이전에 만든 Certificate Signing Request(인증서 서명 요청) 인증서를 찾아서 선택한 다음, Open(열기)을 선택합니다.
5. 를 선택합니다 계속.
6. 개발 인증서를 다운로드하고 저장한 위치를 기억합니다.
Certificates, Identifiers & Profiles(인증서, 식별자 및 프로필) 페이지로 돌아가고, 왼쪽 메뉴에서 Profiles(프로필)를 선택한 다음, +를 선택하여 새 프로필을 만듭니다. Register a New Provisioning Profile(새 프로비저닝 프로필 등록) 화면이 표시됩니다.
Select certificates(인증서 선택) 창에서 방금 만든 개발 인증서를 선택합니다. 그런 다음 계속을 선택합니다.
다음으로 테스트에 사용할 디바이스를 선택하고, 계속을 선택합니다.
마지막으로 프로비저닝 프로필 이름에서 이름을 선택하고, 생성을 선택합니다.

선택
새 프로비저닝 프로필이 만들어지면 다운로드를 선택합니다. 저장되는 위치를 기억합니다.
프로비저닝 프로필의 위치를 찾은 다음, 해당 프로필을 두 번 클릭하여 Xcode 개발 머신에 설치합니다.

알림 허브 만들기

이 섹션에서는 .p12 푸시 인증서 또는 토큰 기반 인증을 사용하여 알림 허브를 만들고 APN으로 인증을 구성합니다. 이미 만든 알림 허브를 사용하려는 경우 5단계로 건너뛸 수 있습니다.

Azure Portal에 로그인합니다.
왼쪽 메뉴에서 모든 서비스를 선택하고, 모바일 섹션에서 Notification Hubs를 선택합니다. 서비스 이름 옆의 별표 아이콘을 선택하여 서비스를 왼쪽 메뉴의 즐겨찾기 섹션에 추가합니다. 먼저 Notification Hubs를 즐겨찾기에 추가한 후, 왼쪽 메뉴에서 선택합니다.

선택
Notification Hubs 페이지의 도구 모음에서 추가를 선택합니다.
Notification Hub 페이지에서 다음 단계를 수행합니다.
1. 알림 허브에 이름을 입력합니다.
2. 새 네임스페이스 만들기에 이름을 입력합니다. 네임스페이스에는 하나 이상의 허브가 포함되어 있습니다.
3. 위치 드롭다운 목록 상자에서 값을 선택합니다. 이 값은 허브를 만들려는 위치를 지정합니다.
4. 리소스 그룹기존 리소스 그룹을 선택하거나 새 리소스 그룹의 이름을 만듭니다.
5. 선택하고생성합니다.
  
  Azure Portal 설정
알림(벨 아이콘)을 선택하고, 리소스로 이동을 선택합니다. Notification Hubs 페이지의 목록을 새로 고치고 허브를 선택할 수도 있습니다.
목록에서 액세스 정책을 선택합니다. 참고로 두 가지 연결 문자열이 제공됩니다. 나중에 푸시 알림을 처리하는 데 필요합니다.

중요합니다

애플리케이션에서 사용하지 말아야 할 DefaultFullSharedAccessSignature 정책이 있습니다. 이는 백엔드에서만 사용하도록 되어 있습니다.

azure Portal

APN 정보를 사용하여 알림 허브 구성

Notification Services아래에서 Apple (APNS) 을 선택한 다음, Notification Hubs 인증서 만들기 섹션에서 이전에 선택한 접근 방식에 따라 적절한 단계를 수행합니다.

비고

스토어에서 앱을 구매한 사용자에게 푸시 알림을 보내려는 경우에만 애플리케이션 모드프로덕션 사용합니다.

옵션 1: .p12 푸시 인증서 사용

인증서를 선택합니다.
파일 아이콘을 선택합니다.
이전에 내보낸 .p12 파일을 선택한 다음, 열기를 선택합니다.
필요한 경우 올바른 암호를 지정합니다.
샌드박스 모드를 선택합니다.

Azure 포털에서 APNs 인증 구성
저장을 선택합니다.

옵션 2: 토큰 기반 인증 사용

토큰을 선택합니다.
앞서 얻은 다음 값을 입력합니다.
- 키 ID
- 번들 ID
- 팀 ID
- 토큰
샌드박스 선택
저장을 선택합니다.

이제 APN을 사용하여 알림 허브를 구성했습니다. 또한 앱을 등록하고 푸시 알림을 보내는 연결 문자열도 있습니다.

APNS에 대한 알림 허브 구성

Mac에서 Keychain Access시작합니다. 왼쪽 탐색 모음의 범주아래에서 내 인증서를 엽니다. 이전 섹션에서 다운로드한 SSL 인증서를 찾은 다음 해당 내용을 공개합니다. 인증서만 선택합니다(프라이빗 키를 선택하지 않음). 그런 다음 내보냅니다.
Azure Portal모든>App Services찾아보기를 선택합니다. 그런 다음 Mobile Apps 백 엔드를 선택합니다.
설정에서 App Service 푸시를 선택합니다. 그런 다음 알림 허브 이름을 선택합니다.
Apple Push Notification Services >인증서업로드로 이동합니다. .p12 파일을 업로드하여 올바른 모드 선택합니다(이전의 클라이언트 SSL 인증서가 프로덕션 또는 샌드박스인지 여부에 따라 다름). 변경 내용을 저장합니다.

이제 서비스가 iOS에서 푸시 알림으로 작동하도록 구성되었습니다.

다음으로 Xamarin Studio 또는 Visual Studio에서 iOS 프로젝트 설정을 구성합니다.

Xamarin Studio에서 iOS 프로젝트 구성

Xamarin.Studio에서 Info.plist열고 번들 식별자 새 앱 ID로 이전에 만든 번들 ID로 업데이트합니다.
백그라운드 모드로 아래로 스크롤하십시오. 백그라운드 모드 사용 상자와 원격 알림 상자를 선택합니다.
솔루션 패널에서 프로젝트를 두 번 클릭하여 프로젝트 옵션엽니다.
빌드아래에서 iOS 번들 서명 선택하고 이 프로젝트에 대해 방금 설정한 해당 ID 및 프로비저닝 프로필을 선택합니다.

이렇게 하면 프로젝트가 코드 서명에 새 프로필을 사용합니다. 공식 Xamarin 디바이스 프로비저닝 설명서는 Xamarin Device Provisioning참조하세요.

Visual Studio에서 iOS 프로젝트 구성

Visual Studio에서 프로젝트를 마우스 오른쪽 단추로 클릭한 다음 속성클릭합니다.
속성 페이지에서 iOS 애플리케이션 탭을 클릭하고 식별자 앞에서 만든 ID로 업데이트합니다.
iOS 번들 서명 탭에서 이 프로젝트에 대해 방금 설정한 해당 ID 및 프로비저닝 프로필을 선택합니다.

이렇게 하면 프로젝트가 코드 서명에 새 프로필을 사용합니다. 공식 Xamarin 디바이스 프로비저닝 설명서는 Xamarin Device Provisioning참조하세요.
Info.plist를 두 번 클릭하여 열고, 그런 다음 백그라운드 모드에서 RemoteNotifications을 사용하도록 설정합니다.

iOS 앱에 푸시 알림 추가

iOS 프로젝트에서 AppDelegate.cs 열고 코드 파일의 맨 위에 다음 문을 추가합니다.
```
using Newtonsoft.Json.Linq;
```

AppDelegate 클래스에서 RegisteredForRemoteNotifications 이벤트에 대한 재정의를 추가하여 알림 등록을 위한 프로세스를 수행합니다.

public override void RegisteredForRemoteNotifications(UIApplication application,
    NSData deviceToken)
{
    const string templateBodyAPNS = "{\"aps\":{\"alert\":\"$(messageParam)\"}}";

    JObject templates = new JObject();
    templates["genericMessage"] = new JObject
        {
            {"body", templateBodyAPNS}
        };

    // Register for push with your mobile app
    Push push = TodoItemManager.DefaultManager.CurrentClient.GetPush();
    push.RegisterAsync(deviceToken, templates);
}

AppDelegate에서 DidReceiveRemoteNotification 이벤트 처리기 메서드에 대한 다음 재정의 메서드를 추가합니다.

public override void DidReceiveRemoteNotification(UIApplication application,
    NSDictionary userInfo, Action<UIBackgroundFetchResult> completionHandler)
{
    NSDictionary aps = userInfo.ObjectForKey(new NSString("aps")) as NSDictionary;

    string alert = string.Empty;
    if (aps.ContainsKey(new NSString("alert")))
        alert = (aps[new NSString("alert")] as NSString).ToString();

    //show alert
    if (!string.IsNullOrEmpty(alert))
    {
        UIAlertView avAlert = new UIAlertView("Notification", alert, null, "OK", null);
        avAlert.Show();
    }
}

이 메서드는 앱이 실행되는 동안 들어오는 알림을 처리합니다.

AppDelegate 클래스에서 FinishedLaunching 메서드에 다음 코드를 추가합니다.

// Register for push notifications.
var settings = UIUserNotificationSettings.GetSettingsForTypes(
    UIUserNotificationType.Alert
    | UIUserNotificationType.Badge
    | UIUserNotificationType.Sound,
    new NSSet());

UIApplication.SharedApplication.RegisterUserNotificationSettings(settings);
UIApplication.SharedApplication.RegisterForRemoteNotifications();

이렇게 하면 원격 알림 및 요청 푸시 등록을 지원할 수 있습니다.

이제 푸시 알림을 지원하도록 앱이 업데이트되었습니다.

iOS 앱에서 푸시 알림 테스트

iOS 프로젝트를 마우스 오른쪽 단추로 클릭하고 시작 프로젝트로 설정을 클릭합니다.
Visual Studio에서 실행 단추 또는 F5 눌러 프로젝트를 빌드하고 iOS 디바이스에서 앱을 시작합니다. 그런 다음 확인 클릭하여 푸시 알림을 수락합니다.

비고

앱에서 푸시 알림을 명시적으로 수락해야 합니다. 이 요청은 앱이 처음 실행되는 경우에만 발생합니다.
앱에서 작업을 입력한 다음 더하기(+) 아이콘을 클릭합니다.
알림이 수신되었는지 확인한 다음 확인 클릭하여 알림을 해제합니다.

Windows 프로젝트 구성 및 실행(선택 사항)

이 섹션은 Windows 디바이스용 Xamarin.Forms WinApp 및 WinPhone81 프로젝트를 실행하기 위한 것입니다. 이러한 단계는 UWP(유니버설 Windows 플랫폼) 프로젝트도 지원합니다. Windows 디바이스를 사용하지 않는 경우 이 섹션을 건너뛸 수 있습니다.

WNS(Windows 알림 서비스)에 푸시 알림용 Windows 앱 등록

Visual Studio 솔루션 탐색기에서 Windows 스토어 앱 프로젝트를 마우스 오른쪽 단추로 클릭합니다. 그런 다음 스토어>앱을 스토어와 연결합니다.

연관 짓기
마법사에서 다음을 선택합니다. 그런 다음 Microsoft 계정으로 로그인합니다. 새 앱 이름예약에서 앱의 이름을 입력한 다음 예약선택합니다.
앱 등록이 성공적으로 만들어지면 새 앱 이름을 선택합니다. 다음을 선택하고 연결을 선택하세요. 이 프로세스는 필요한 Windows 스토어 등록 정보를 애플리케이션 매니페스트에 추가합니다.
이전에 Windows 스토어 앱에 대해 만든 것과 동일한 등록을 사용하여 Windows Phone 스토어 앱 프로젝트에 대해 1단계와 3단계를 반복합니다.
Windows 개발자 센터이동한 다음 Microsoft 계정으로 로그인합니다. 내 앱에서, 새 앱 등록을 선택합니다. 그런 다음 Services>푸시 알림확장합니다.
푸시 알림 페이지의 WNS(Windows 푸시 알림 서비스) 및 Microsoft Azure Mobile Apps아래에서 Live Services 사이트를 선택합니다. 패키지 SID 값과 Application Secret의 현재 값을 기록합니다.

중요합니다

애플리케이션 비밀 및 패키지 SID는 중요한 보안 자격 증명입니다. 이러한 값을 다른 사용자와 공유하거나 앱과 배포하지 마세요.

WNS에 대한 알림 허브 구성

Azure Portal모든>App Services찾아보기를 선택합니다. 그런 다음 Mobile Apps 백 엔드를 선택합니다. 설정에서 App Service 푸시를 선택합니다. 그런 다음 알림 허브 이름을 선택합니다.
Windows (WNS)로 이동합니다. 그런 다음, Live Services 사이트에서 가져온 보안 키(클라이언트 암호) 및 패키지 SID 입력합니다. 그런 다음, 저장을 선택합니다.

에 설정하십시오

이제 백 엔드가 WNS를 사용하여 푸시 알림을 보내도록 구성됩니다.

Windows 앱에 푸시 알림 추가

Visual Studio에서 Windows 프로젝트에서 App.xaml.cs 열고 다음 문을 추가합니다.
```
using Newtonsoft.Json.Linq;
using Microsoft.WindowsAzure.MobileServices;
using System.Threading.Tasks;
using Windows.Networking.PushNotifications;
using <your_TodoItemManager_portable_class_namespace>;
```
<your_TodoItemManager_portable_class_namespace> TodoItemManager 클래스가 포함된 이식 가능한 프로젝트의 네임스페이스로 바꿉니다.

App.xaml.cs 다음 InitNotificationsAsync 메서드를 추가합니다.

private async Task InitNotificationsAsync()
{
    var channel = await PushNotificationChannelManager
        .CreatePushNotificationChannelForApplicationAsync();

    const string templateBodyWNS =
        "<toast><visual><binding template=\"ToastText01\"><text id=\"1\">$(messageParam)</text></binding></visual></toast>";

    JObject headers = new JObject();
    headers["X-WNS-Type"] = "wns/toast";

    JObject templates = new JObject();
    templates["genericMessage"] = new JObject
    {
        {"body", templateBodyWNS},
        {"headers", headers} // Needed for WNS.
    };

    await TodoItemManager.DefaultManager.CurrentClient.GetPush()
        .RegisterAsync(channel.Uri, templates);
}

이 메서드는 푸시 알림 채널을 가져오고 알림 허브에서 템플릿 알림을 받을 템플릿을 등록합니다. messageParam 지원하는 템플릿 알림이 이 클라이언트에 전달됩니다.

App.xaml.cs에서 한정자를 추가하여 async 이벤트 처리기 메서드 정의를 업데이트합니다. 그런 다음 메서드의 끝에 다음 코드 줄을 추가합니다.
```
await InitNotificationsAsync();
```
이렇게 하면 앱이 시작될 때마다 푸시 알림 등록이 생성되거나 새로 고쳐집니다. WNS 푸시 채널이 항상 활성화되도록 하려면 이 작업을 수행하는 것이 중요합니다.
Visual Studio의 솔루션 탐색기에서 Package.appxmanifest 파일을 열고, 알림아래에서 알림 가능을 예로 설정합니다.
앱을 빌드하고 오류가 없는지 확인합니다. 이제 클라이언트 앱이 Mobile Apps 백 엔드에서 템플릿 알림을 등록해야 합니다. 솔루션의 모든 Windows 프로젝트에 대해 이 섹션을 반복합니다.

Windows 앱에서 푸시 알림 테스트

Visual Studio에서 Windows 프로젝트를 마우스 오른쪽 버튼으로 클릭한 후, 시작 프로젝트로 설정을 클릭합니다.
실행 단추를 눌러 프로젝트를 빌드하고 앱을 시작합니다.
앱에서 새 todoitem의 이름을 입력한 다음 더하기(+) 아이콘을 클릭하여 추가합니다.
항목이 추가될 때 알림이 수신되는지 확인합니다.

다음 단계

푸시 알림에 대해 자세히 알아볼 수 있습니다.

Azure Mobile Apps에서 푸시 알림 보내기
Firebase Cloud Messaging
Firebase Cloud Messaging 사용하여 원격 알림
푸시 알림 문제 진단
알림이 삭제되거나 디바이스에서 종료되지 않는 데는 여러 가지 이유가 있습니다. 이 항목에서는 푸시 알림 실패의 근본 원인을 분석하고 파악하는 방법을 보여 줍니다.

다음 자습서 중 하나를 계속 진행할 수도 있습니다.

앱에 인증을 추가하세요
ID 공급자를 사용하여 앱의 사용자를 인증하는 방법을 알아봅니다.
귀하의 앱에 오프라인 동기화를 활성화
Mobile Apps 백 엔드를 사용하여 앱에 대한 오프라인 지원을 추가하는 방법을 알아봅니다. 오프라인 동기화를 사용하면 네트워크 연결이 없는 경우에도 사용자가 모바일 앱(데이터 보기, 추가 또는 수정)과 상호 작용할 수 있습니다.

Last updated on 2019-06-25