diff --git a/README-Localized/README-es-es.md b/README-Localized/README-es-es.md new file mode 100644 index 0000000..2b86500 --- /dev/null +++ b/README-Localized/README-es-es.md @@ -0,0 +1,111 @@ +# Proveedor de autenticación de MSAL para Objetive-C +Esta biblioteca cliente es una versión candidata para lanzamiento y todavía está en estado de versión preliminar. Siga proporcionando comentarios a medida que iteramos hacia una biblioteca compatible con la producción. + +Esta biblioteca proporciona la implementación de MSAuthenticationProvider que puede usarse para iniciar el desarrollo con el [SDK de Microsoft Graph para ObjC](https://github.com/microsoftgraph/msgraph-sdk-objc) + +Nota: Actualmente, esta biblioteca solo es compatible con la plataforma iOS. La compatibilidad con MacOS se proporcionará en una versión futura. + +## Instalación + +### Usar CocoaPods + +Puede usar [CocoaPods](https://cocoapods.org/) para mantenerse actualizado con la versión más reciente. Incluya la siguiente línea en su podfile: + ``` + pod 'MSGraphMSALAuthProvider' + ``` + + +### Usar Carthage + + +También puede optar por usar [Carthage](https://github.com/Carthage/Carthage) para administrar paquetes. + + + +1. Instale Carthage en su Mac con una descarga desde el sitio web o si usa el Homebrew `brew install carthage`. + +2. Debe crear un `Cartfile` que enumere la biblioteca MSGraphMSALAuthProvider para este proyecto en Github. + + + +``` + +github "microsoftgraph/msgraph-sdk-objc-auth" "tags/" + +``` + + + +3. Ejecute `carthage update`. Esto recuperará las dependencias en una carpeta `Carthage/Checkouts` y después, compilará la biblioteca. + +4. En la pestaña de configuración "General" de destino de la aplicación, en la sección "Marcos y bibliotecas vinculadas", arrastre y coloque el `MSGraphMSALAuthProvider.framework` desde la carpeta `Carthage/Build` en el disco. + +5. En la pestaña de configuración "Fases de compilación" de destino de la aplicación, haga clic en el icono "+" y elija "Nueva fase de ejecución de script". Cree un Script de ejecución en el que especifique el shell (ej.: `/bin/sh`), agregue el siguiente contenido en el área de script debajo del shell: + + + +```sh + +/usr/local/bin/carthage copy-frameworks + +``` + + + +y agregue las rutas de acceso a los marcos que desea usar en "Archivos de entrada", por ejemplo: + + + +``` + +$(SRCROOT)/Carthage/Build/iOS/MSGraphMSALAuthProvider.framework + +``` + +Este script funciona alrededor de un [Error de envío de la App Store](http://www.openradar.me/radar?id=6409498411401216) desencadenado por archivos binarios universales y garantiza que los archivos relacionados con bitcode y los dSYMs necesarios se copien al archivar. + + + +Con la información de depuración copiada en el directorio de productos compilados, Xcode podrá resolver símbolos en el seguimiento de pila cuando se detenga en un punto de interrupción. Esto también le permite desplazarse por el código de terceros en el depurador. + + + +Al archivar la aplicación para enviarla a la App Store o TestFlight, Xcode también copiará estos archivos en el subdirectorio dSYMs del paquete `.xcarchive` de la aplicación. + +## Requisitos previos + +Esta biblioteca tiene dos dependencias que sirven a su propio propósito específico: + +1. [MSAL](https://github.com/AzureAD/microsoft-authentication-library-for-objc)Esta dependencia se ha agregado para administrar todos los Escenarios específicos de autenticación. + +2. [MSGraphClientSDK](https://github.com/microsoftgraph/msgraph-sdk-objc) Esta dependencia se ha agregado para seleccionar el protocolo MSAuthenticationProvider desde MSGraphClientSDK para que MSGraphClientSDK pueda comunicarse con esta biblioteca para obtener el token necesario. + +Por lo tanto, para usar esta biblioteca, también tendrá que agregar los dos marcos anteriores en su proyecto. + +## Cómo se usa + +Suponiendo que ha seguido los pasos anteriores y ha agregado los marcos de trabajo o pods requeridos, el proyecto ahora tendrá todo lo que necesita. + +Así que, ahora solo debe seguir los pasos que se indican a continuación: + +1. Cree una instancia de clase `MSALPublicClientApplication` según las instrucciones proporcionadas aquí [MSAL](https://github.com/AzureAD/microsoft-authentication-library-for-objc). Asegúrese de seguir otros pasos descritos en el archivo readme de MSAL para crear correctamente esta instancia. Podría ser parecido al siguiente ejemplo: +``` +NSError *error = nil; +MSALPublicClientApplication *application = +[[MSALPublicClientApplication alloc] initWithClientId:@"" +error:&error]; +``` +2. Cree una instancia de `MSALAuthenticationProviderOptions` como se muestra a continuación: +``` +MSALAuthenticationProviderOptions *authProviderOptions= [[MSALAuthenticationProviderOptions alloc] initWithScopes:]; +``` + +3. Cree una instancia de `MSALAuthenticationProvider` de la siguiente forma, mediante las instancias`MSALPublicClientApplication` y `MSALAuthenticationProviderOptions` que creó en los pasos anteriores: +``` + MSALAuthenticationProvider *authProvider = [[MSALAuthenticationProvider alloc] initWithPublicClientApplication:publicClientApplication andOptions:authProviderOptions]; +``` +Ahora tiene una instancia que sigue el protocolo de MSAuthenticationProvider y está configurada con una instancia MSALPublicClientApplication para administrar escenarios de autenticación. + + 3. Ahora puede usar este authenticationProvider junto con MSGraphClientSDK para realizar llamadas de red autenticadas al servidor de Microsoft Graph. Vaya a [Cómo usar MSGraphClientSDK](https://github.com/microsoftgraph/msgraph-sdk-objc#how-to-use-sdk) para obtener información sobre cómo puede usar esto. + +Por ahora, tendrá todo en funcionamiento. diff --git a/README-Localized/README-fr-fr.md b/README-Localized/README-fr-fr.md new file mode 100644 index 0000000..1ef62d8 --- /dev/null +++ b/README-Localized/README-fr-fr.md @@ -0,0 +1,111 @@ +# Fournisseur d’authentification MSAL pour Objective C +Cette bibliothèque cliente est une version finale et se présente encore en état aperçu. Nous vous invitons à nous envoyer vos commentaires au fur et à mesure de l'itération vers une bibliothèque prise en charge par la production. + +Cette bibliothèque fournit une implémentation de MSAuthenticationProvider qui peut être utilisé pour démarrer le développement avec le [Kit de développement logiciel (SDK) Microsoft Graph pour ObjC](https://github.com/microsoftgraph/msgraph-sdk-objc) + +Remarque : Cette bibliothèque prend actuellement en charge la plateforme iOS uniquement. La prise en charge de MacOS sera fournie dans une version ultérieure. + +## Installation + +### Utilisation de CocoaPods + +Vous pouvez utiliser [CocoaPods](https://cocoapods.org/) pour rester informé sur la dernière version. Incluez la ligne suivante dans votre podfile : + ``` + pod 'MSGraphMSALAuthProvider' + ``` + + +### Utilisation de Carthage + + +Vous pouvez également choisir de recourir à [Carthage](https://github.com/Carthage/Carthage) pour la gestion des packages. + + + +1. Installez Carthage sur votre Mac à l’aide d’un téléchargement à partir de leur site web, ou si vous utilisez Homebrew `brew install Carthage`. + +2. Vous devez créer un `cartfile` qui répertorie la bibliothèque MSGraphMSALAuthProvider pour ce projet sur GitHub. + + + +``` + +github "microsoftgraph/msgraph-sdk-objc-auth" "tags/" + +``` + + + +3. Exécutez la `mise à jour carthage`. Elle récupère les dépendances dans un dossier `Carthage/Checkouts`, puis génère la bibliothèque. + +4. Sous l’onglet de Paramètres « Général » de votre cible d'application, dans la section « Bibliothèques et infrastructures liées », faites glisser et déposez le `MSGraphMSALAuthProvider.framework` à partir du dossier `Carthage/Build` sur le disque. + +5. Dans l’onglet de Paramètres « Phases de Build » de la cible d'application, cliquez sur l’icône « + », puis sélectionnez « Nouvelle phase d'exécution du script ». Créez un Script d'exécution dans lequel vous spécifiez votre interpréteur de commandes (par exemple, `/bin/sh`), ajoutez le contenu suivant à la zone de script sous l’interpréteur : + + + +```sh + +/usr/local/bin/carthage copy-frameworks + +``` + + + +et ajoutez les chemins d’accès aux infrastructures que vous voulez utiliser sous « Fichiers d’entrée », par ex. : + + + +``` + +$(SRCROOT)/Carthage/Build/iOS/MSGraphMSALAuthProvider.framework + +``` + +Ce script se consacre au [bogue de soumission App Store,](http://www.openradar.me/radar?id=6409498411401216) déclenché par des fichiers binaires universels et vous permet de vous assurer que les fichiers liés au bitcode et les dSYMs nécessaires sont copiés lors de l’archivage. + + + +Une fois les informations de débogage copiées dans l’annuaire des produits built, Xcode pourra générer des symboles d'arborescence des appels de procédure chaque fois que vous vous arrêtez à un point d’arrêt. Cela vous permet également de parcourir le code tiers dans le débogueur. + + + +Lors de l’archivage de votre application à des fins de soumission vers l’App Store ou le TestFlight, Xcode copiera également ces fichiers dans le sous-répertoire dSYMs du groupe `.xcarchive` de l'application. + +## Conditions préalables + +Cette bibliothèque a deux dépendances ayant une finalité spécifique : + +1. [MSAL](https://github.com/AzureAD/microsoft-authentication-library-for-objc) cette dépendance a été ajoutée pour gérer tous les scénarios propres à l’Authentification. + +2. [MSGraphClientSDK](https://github.com/microsoftgraph/msgraph-sdk-objc) cette dépendance a été ajoutée pour sélectionner le protocole MSAuthenticationProvider de MSGraphClientSDK de sorte que MSGraphClientSDK puisse communiquer avec cette bibliothèque pour obtenir le jeton nécessaire. + +Pour pouvoir utiliser cette bibliothèque, vous devez donc également ajouter au-dessus deux infrastructures dans votre projet. + +## Utilisation + +En supposant que vous avez suivi les étapes ci-dessus et ajouté les infrastructures ou pods requis, votre projet dispose désormais des informations nécessaires. + +Il vous suffit de suivre maintenantn les étapes ci-dessous : + +1. Créez une instance de classe `MSALPublicClientApplication` conforme aux instructions fournies ici [MSAL](https://github.com/AzureAD/microsoft-authentication-library-for-objc). Assurez-vous de suivre les autres étapes décrites dans MSAL Readme pour créer correctement cette instance. Elle peut ressembler à ceci : +``` +NSError *error = nil; +MSALPublicClientApplication *application = +[[MSALPublicClientApplication alloc] initWithClientId:@"" +error:&error]; +``` +2. Créez une instance de `MSALAuthenticationProviderOptions` comme suit : +``` +MSALAuthenticationProviderOptions *authProviderOptions= [[MSALAuthenticationProviderOptions alloc] initWithScopes:]; +``` + +3. Créez une instance de `MSALAuthenticationProvider` comme décrite ci-dessous à l’aide des instances `MSALPublicClientApplication` et `MSALAuthenticationProviderOptions` que vous avez créées dans les étapes précédentes : +``` + MSALAuthenticationProvider *authProvider = [[MSALAuthenticationProvider alloc] initWithPublicClientApplication:publicClientApplication andOptions:authProviderOptions]; +``` +Vous disposez à présent d’une instance qui suit le protocole MSAuthenticationProvider et qui est configurée avec une instance MSALPublicClientApplication pour gérer les scénarios d’authentification. + + 3. Vous pouvez désormais utiliser ce authenticationProvider conjointement avec MSGraphClientSDK pour établir des appels réseau authentifiés vers Microsoft Graph Server. Consultez la rubrique [Utiliser MSGraphClientSDK](https://github.com/microsoftgraph/msgraph-sdk-objc#how-to-use-sdk) pour voir comment vous pouvez l’utiliser. + +À ce stade, tout est prêt pour bien commencer. diff --git a/README-Localized/README-ja-jp.md b/README-Localized/README-ja-jp.md new file mode 100644 index 0000000..6bcdf85 --- /dev/null +++ b/README-Localized/README-ja-jp.md @@ -0,0 +1,111 @@ +# Objective C 用 MSAL 認証プロバイダ +このクライアント ライブラリはリリース候補であり、まだプレビューの状態にあります。運用環境でサポートされるライブラリを目標としておりますので、引き続きフィードバックをご提供ください。 + +このライブラリは、[ObjC 用 Microsoft Graph SDK](https://github.com/microsoftgraph/msgraph-sdk-objc) で開発を開始するために使用可能な MSAuthenticationProvider の実装を提供します + +注:このライブラリは現在、iOS プラットフォームのみをサポートしています。MacOS サポートは将来のリリースで提供される予定です。 + +## インストール + +### CocoaPods を使う + +[CocoaPods](https://cocoapods.org/) を使用すれば、最新バージョンを使用して最新の状態に保つことができます。ポッドファイルに次の行を含めます: + ``` + pod 'MSGraphMSALAuthProvider' + ``` + + +### Carthage を使う + + +パッケージ管理に [Carthage](https://github.com/Carthage/Carthage) を使用することもできます。 + + + +1. Mac に Carthage をインストールするには、Web サイトからダウンロードするか、Homebrew を使用している場合には `brew install carthage` を使用します。 + +2. Github でこのプロジェクトの MSGraphMSALAuthProvider ライブラリを一覧表示する `Cartfile` を作成する必要があります。 + + + +``` + +github "microsoftgraph/msgraph-sdk-objc-auth" "tags/" + +``` + + + +3. `carthage update` を実行します。このコマンドは依存性を取り出して `Carthage/Checkouts` フォルダーに入れ、ライブラリをビルドします。 + +4. アプリケーション ターゲットの \[全般] 設定タブの \[リンクされたフレームワークとライブラリ] セクションで、`MSGraphMSALAuthProvider.framework` をディスク上の `Carthage/Build` フォルダーからドラッグアンドドロップします。 + +5. アプリケーション ターゲットの \[ビルド フェーズ] 設定タブで、\[+] アイコンをクリックして \[新規スクリプト実行フェーズ] を選択します。シェル (例: `/bin/sh`) を指定して実行スクリプトを作成し、シェルの下のスクリプト領域に次のコンテンツを追加します。 + + + +```sh + +/usr/local/bin/carthage copy-frameworks + +``` + + + +使用するフレームワークへのパスを “入力ファイル” の下に追加します。例: + + + +``` + +$(SRCROOT)/Carthage/Build/iOS/MSGraphMSALAuthProvider.framework + +``` + +このスクリプトは、ユニバーサル バイナリによってトリガーされる [App Store 提出バグ](http://www.openradar.me/radar?id=6409498411401216)を回避し、必要なビットコード関連ファイルおよび dSYM がアーカイブ時に確実にコピーされるようにします。 + + + +デバッグ情報が構築された製品ディレクトリにコピーされると、Xcode はブレークポイントで停止するたびにスタック トレースを記号化できます。これにより、デバッガーでサードパーティのコードをステップ実行することもできます。 + + + +App Store または TestFlight に提出するためにアプリケーションをアーカイブする場合、Xcode はこれらのファイルをアプリケーションの `.xcarchive` バンドルの dSYMs サブディレクトリにもコピーします。 + +## 前提条件 + +このライブラリには 2 つの依存関係があり、両方ともそれぞれの具体的な目的を果たします。 + +1. [MSAL](https://github.com/AzureAD/microsoft-authentication-library-for-objc) この依存関係は、すべての認証固有のシナリオを処理するために追加されました。 + +2. [MSGraphClientSDK](https://github.com/microsoftgraph/msgraph-sdk-objc) この依存関係は、MSGraphClientSDK がこのライブラリと通信して必要なトークンを取得できるように、MSGraphClientSDK から MSAuthenticationProvider プロトコルを選択するために追加されました。 + +したがって、このライブラリを使用するには、上記 2 つのフレームワークもプロジェクトに追加する必要があります。 + +## 使用方法 + +上記の手順を完了し、必要なフレームワークまたは Pod を追加したと仮定すると、プロジェクトには必要なものがすべて揃っているはずです。 + +そのため、次の手順に従う必要があります。 + +1. こちら [MSAL](https://github.com/AzureAD/microsoft-authentication-library-for-objc) で提供されている手順に従って、`MSALPublicClientApplication` クラスのインスタンスを作成します。このインスタンスを適切に作成するには、MSAL の Readme に記載されているその他の手順に従っていることを確認してください。以下のようになります。 +``` +NSError *error = nil; +MSALPublicClientApplication *application = +[[MSALPublicClientApplication alloc] initWithClientId:@"" +error:&error]; +``` +2. 以下のような `MSALAuthenticationProviderOptions` のインスタンスを作成します。 +``` +MSALAuthenticationProviderOptions *authProviderOptions= [[MSALAuthenticationProviderOptions alloc] initWithScopes:]; +``` + +3. 前の手順で作成した `MSALPublicClientApplication` および `MSALAuthenticationProviderOptions` インスタンスを使用して、以下の方法で `MSALAuthenticationProvider` のインスタンスを作成します。 +``` + MSALAuthenticationProvider *authProvider = [[MSALAuthenticationProvider alloc] initWithPublicClientApplication:publicClientApplication andOptions:authProviderOptions]; +``` +これで、MSAuthenticationProvider プロトコルに従い、認証シナリオを処理するために MSALPublicClientApplication インスタンスで構成されるインスタンスが作成されました。 + + 3. これで、この authenticationProvider を MSGraphClientSDK と併用して、Microsoft Graph サーバーへの認証済みネットワークの呼び出しを行うことができます。「[How to use MSGraphClientSDK (MSGraphClientSDK の使用方法)](https://github.com/microsoftgraph/msgraph-sdk-objc#how-to-use-sdk)」に進み、使用方法を確認してください。 + +ここまでで、すべての準備および実行が完了しているはずです。 diff --git a/README-Localized/README-pt-br.md b/README-Localized/README-pt-br.md new file mode 100644 index 0000000..ad33b29 --- /dev/null +++ b/README-Localized/README-pt-br.md @@ -0,0 +1,111 @@ +# Provedor de autenticação MSAL para Objective-C +Essa biblioteca de clientes é uma candidata a versão e ainda está no status de versão prévia. Continue a fornecer comentários enquanto iteramos a fim de fornecer uma biblioteca com suporte para produção. + +Esta biblioteca fornece a implementação de MSAuthenticationProvider que podem ser usado para começar a desenvolver com o [SDK do Microsoft Graph para ObjC](https://github.com/microsoftgraph/msgraph-sdk-objc) + +Observação: no momento, esta biblioteca tem suporte apenas para a plataforma iOS. O suporte para MacOS será fornecido em futuras versões. + +## Instalação + +### Usando o CocoaPods + +Você pode usar o [CocoaPods](https://cocoapods.org/) para se manter atualizado com a versão mais recente. Inclua a seguinte linha no seu podfile: + ``` + pod 'MSGraphMSALAuthProvider' + ``` + + +### Usando o Carthage + + +Você também pode optar por usar o [Carthage](https://github.com/Carthage/Carthage) no gerenciamento de pacotes. + + + +1. Instale o Carthage no Mac baixando do site ou, se estiver usando o Homebrew, use `brew install carthage`. + +2. Você deve criar um `Cartfile` que lista a biblioteca MSGraphMSALAuthProvider desse projeto no Github. + + + +``` + +github "microsoftgraph/msgraph-sdk-objc-auth" "tags/" + +``` + + + +3. Execute `carthage update`. Este comando busca dependências na pasta `Carthage/Checkouts` e cria a biblioteca. + +4. Na guia das configurações "Gerais" do destino do aplicativo, na seção "Estruturas e Bibliotecas Vinculadas", arraste e solte o `MSGraphMSALAuthProvider.framework` da pasta `Carthage/Build` no disco. + +5. Na guia de configurações "Fases do Build" do destino do aplicativo, clique no ícone "+" e escolha "Nova Fase de Script de Execução". Crie um Script de Execução no qual você especifica o shell (por exemplo, `/bin/sh`); adicione o seguinte conteúdo à área de script abaixo do shell: + + + +```sh + +/usr/local/bin/carthage copy-frameworks + +``` + + + +e adicione os caminhos para as estruturas que você deseja usar em "arquivos de entrada", como, por exemplo: + + + +``` + +$(SRCROOT)/Carthage/Build/iOS/MSGraphMSALAuthProvider.framework + +``` + +Este script funciona em torno de um [Bug de envio da App Store](http://www.openradar.me/radar?id=6409498411401216) acionado por binários universais e garante que os arquivos necessários relacionados a BitCode e dSYMs sejam copiados durante o arquivamento. + + + +Com as informações de depuração copiadas no diretório de produtos criados, o Xcode poderá simbolizar o rastreamento da pilha sempre que você parar em um ponto de interrupção. Isso também permitirá que você percorra o código de terceiros no depurador. + + + +Ao arquivar o aplicativo para envio para a App Store ou TestFlight, o Xcode também copia esses arquivos no subdiretório dSYMs do pacote `.xcarchive` do aplicativo. + +## Pré-requisitos + +Essa biblioteca tem duas dependências que atendem às suas finalidades específicas: + +1. [MSAL](https://github.com/AzureAD/microsoft-authentication-library-for-objc) Essa dependência foi adicionada para lidar com todos os cenários específicos de autenticação. + +2. [MSGraphClientSDK](https://github.com/microsoftgraph/msgraph-sdk-objc) Essa dependência foi adicionada para selecionar o protocolo MSAuthenticationProvider do MSGraphClientSDK para que o MSGraphClientSDK possa se comunicar com essa biblioteca para obter o token necessário. + +Portanto, para usar essa biblioteca, você também terá que adicionar as duas estruturas acima ao seu projeto. + +## Como usar + +Supondo que você tenha acompanhado as etapas acima e adicionado as estruturas ou pods necessários, agora seu projeto terá tudo que precisa. + +Agora você só precisa seguir as etapas abaixo: + +1. Crie uma instância da classe `MSALPublicClientApplication` de acordo as instruções fornecidas aqui [MSAL](https://github.com/AzureAD/microsoft-authentication-library-for-objc). Execute as outras etapas mencionadas no Leiame do MSAL para criar corretamente essa instância. Ela deve se parecer com o seguinte: +``` +NSError *error = nil; +MSALPublicClientApplication *application = +[[MSALPublicClientApplication alloc] initWithClientId:@"" +error:&error]; +``` +2. Crie uma instância de `MSALAuthenticationProviderOptions` como abaixo: +``` +MSALAuthenticationProviderOptions *authProviderOptions= [[MSALAuthenticationProviderOptions alloc] initWithScopes:]; +``` + +3. Crie uma instância de `MSALAuthenticationProvider` na forma abaixo usando as instâncias `MSALPublicClientApplication` e `MSALAuthenticationProviderOptions` que você criou nas etapas anteriores: +``` + MSALAuthenticationProvider *authProvider = [[MSALAuthenticationProvider alloc] initWithPublicClientApplication:publicClientApplication andOptions:authProviderOptions]; +``` +Agora você tem uma instância que segue o protocolo MSAuthenticationProvider e está configurada com uma instância MSALPublicClientApplication para gerenciar cenários de autenticação. + + 3. Agora você pode usar esse authenticationProvider em conjunto com o MSGraphClientSDK para fazer chamadas de rede autenticadas para o servidor do Microsoft Graph. Confira como você pode usá-lo em [Como usar o MSGraphClientSDK](https://github.com/microsoftgraph/msgraph-sdk-objc#how-to-use-sdk). + +Agora tudo já deve estar em funcionamento. diff --git a/README-Localized/README-ru-ru.md b/README-Localized/README-ru-ru.md new file mode 100644 index 0000000..2013bc0 --- /dev/null +++ b/README-Localized/README-ru-ru.md @@ -0,0 +1,111 @@ +# Поставщик проверки подлинности MSAL для Objective-C +Эта клиентская библиотека является релиз-кандидатом и все еще доступна только в предварительной версии. Продолжайте оставлять отзывы, пока мы работаем над созданием версии для рабочей среды. + +Эта библиотека предоставляет реализацию MSAuthenticationProvider, с помощью которой можно быстро приступить к разработке с использованием [пакета SDK Microsoft Graph для ObjC](https://github.com/microsoftgraph/msgraph-sdk-objc). + +Примечание. В настоящее время эта библиотека поддерживает только платформу iOS. Поддержка MacOS появится в будущем выпуске. + +## Установка + +### Использование CocoaPods + +Вы можете использовать [CocoaPods](https://cocoapods.org/), чтобы обеспечить актуальность установленной версии. Включите в свой профиль следующую строку: + ``` + pod 'MSGraphMSALAuthProvider' + ``` + + +### Использование Carthage + + +Вы также можете использовать [Carthage](https://github.com/Carthage/Carthage) для управления пакетами. + + + +1. Чтобы установить Carthage на компьютере Mac, скачайте программу с официального веб-сайта, а если используется Homebrew, выполните команду `brew install carthage`. + +2. На сайте Github необходимо создать для этого проекта файл `Cartfile`, в котором указана библиотека MSGraphMSALAuthProvider. + + + +``` + +github "microsoftgraph/msgraph-sdk-objc-auth" "tags/" + +``` + + + +3. Выполните команду `carthage update`. Эта команда извлечет зависимости в папку `Carthage/Checkouts`, а затем выполнит сборку библиотеки. + +4. На вкладке настроек "Общие" для целевого приложения найдите раздел "Связанные платформы и библиотеки" и перетащите файл `MSGraphMSALAuthProvider.framework` из папки `Carthage/Build` на диске. + +5. На вкладке настроек "Этапы сборки" для целевого приложения нажмите значок "+" и выберите команду "Новый этап сценария выполнения". Создайте сценарий запуска, в котором указана оболочка (пример: `/bin/sh`), и добавьте следующий текст в область сценария под оболочкой: + + + +```sh + +/usr/local/bin/carthage copy-frameworks + +``` + + + +Затем добавьте пути к платформам, которые требуется использовать, в раздел "Входные файлы", например: + + + +``` + +$(SRCROOT)/Carthage/Build/iOS/MSGraphMSALAuthProvider.framework + +``` + +Этот сценарий помогает избежать [ошибки отправки в App Store](http://www.openradar.me/radar?id=6409498411401216), которую вызывают универсальные двоичные файлы, и обеспечивает копирование необходимых файлов, связанных с Bitcode, и dSYM при архивации. + + + +После копирования отладочной информации в каталог собранных продуктов Xcode сможет выражать символами трассировку стека при достижении точек останова. Это также даст вам возможность пошагового выполнения стороннего кода в отладчике. + + + +При архивации приложения для отправки в App Store или TestFlight среда Xcode также скопирует эти файлы в подкаталог dSYMs пакета `.xcarchive` для вашего приложения. + +## Необходимые компоненты + +У этой библиотеки есть две зависимости, каждая из которых предназначена для определенной цели: + +1. [MSAL.](https://github.com/AzureAD/microsoft-authentication-library-for-objc) Эта зависимость была добавлена для обработки всех сценариев, связанных с проверкой подлинности. + +2. [MSGraphClientSDK.](https://github.com/microsoftgraph/msgraph-sdk-objc) Эта зависимость была добавлена для выбора протокола MSAuthenticationProvider из MSGraphClientSDK, чтобы пакет MSGraphClientSDK мог взаимодействовать с этой библиотекой для получения необходимого токена. + +Таким образом, чтобы использовать библиотеку, вам также потребуется добавить в проект две вышеуказанные платформы. + +## Применение + +При условии, что вы прошли вышеуказанные этапы и добавили необходимые платформы или объекты pod, ваш проект теперь будет содержать все необходимое. + +Теперь вам осталось только выполнить указанные ниже действия. + +1. Создайте экземпляр класса `MSALPublicClientApplication` согласно инструкциям, представленным на странице [MSAL](https://github.com/AzureAD/microsoft-authentication-library-for-objc). Чтобы правильно создать этот экземпляр, следуйте инструкциям из файла Readme для MSAL. Он может выглядеть так: +``` +NSError *error = nil; +MSALPublicClientApplication *application = +[[MSALPublicClientApplication alloc] initWithClientId:@"" +error:&error]; +``` +2. Создайте экземпляр `MSALAuthenticationProviderOptions`, как показано ниже. +``` +MSALAuthenticationProviderOptions *authProviderOptions= [[MSALAuthenticationProviderOptions alloc] initWithScopes:]; +``` + +3. Создайте экземпляр `MSALAuthenticationProvider`, как показано ниже, используя экземпляры `MSALPublicClientApplication` и `MSALAuthenticationProviderOptions`, созданные на предыдущих этапах. +``` + MSALAuthenticationProvider *authProvider = [[MSALAuthenticationProvider alloc] initWithPublicClientApplication:publicClientApplication andOptions:authProviderOptions]; +``` +Теперь у вас есть экземпляр, использующий протокол MSAuthenticationProvider и настроенный с экземпляром MSALPublicClientApplication для обработки сценариев с проверкой подлинности. + + 3. Теперь вы можете использовать этот объект authenticationProvider в сочетании с MSGraphClientSDK, чтобы отправлять сетевые вызовы с проверкой подлинности на сервер Microsoft Graph. Соответствующие инструкции представлены в статье [Как использовать MSGraphClientSDK](https://github.com/microsoftgraph/msgraph-sdk-objc#how-to-use-sdk). + +На данный момент у вас все настроено и готово к работе. diff --git a/README-Localized/README-zh-cn.md b/README-Localized/README-zh-cn.md new file mode 100644 index 0000000..ce701e3 --- /dev/null +++ b/README-Localized/README-zh-cn.md @@ -0,0 +1,111 @@ +# 适用于 Objective C 的 MSAL 身份验证提供程序 +此客户端库是候选发布版本,并且仍处于预览状态;在我们对生产支持的库进行迭代时,请继续提供反馈。 + +此库提供了 MSAuthenticationProvider 的实施方案,因此可以使用[适用于 ObjC 的 Microsoft Graph SDK](https://github.com/microsoftgraph/msgraph-sdk-objc) 加快开发进程 + +注意:此库目前仅支持 iOS 平台。在未来版本中将提供 MacOS 支持。 + +## 安装 + +### 使用 CocoaPods + +可使用 [CocoaPods](https://cocoapods.org/) 来保持最新版本。在配置文件中包含下列行: + ``` + pod 'MSGraphMSALAuthProvider' + ``` + + +### 使用 Carthage + + +还可以选择使用 [Carthage](https://github.com/Carthage/Carthage) 管理程序包。 + + + +1. 使用网站中的下载内容或使用 Homebrew `brew install carthage` 将 Carthage 安装到 Mac 上。 + +2. 必须创建一个 `Cartfile`,用于在 Github 上列出此项目的 MSGraphMSALAuthProvider 库。 + + + +``` + +github "microsoftgraph/msgraph-sdk-objc-auth" "tags/" + +``` + + + +3. 运行 `carthage update`。此代码将把依赖项提取到 `Carthage/Checkouts` 文件夹,然后生成库。 + +4. 在应用程序目标的“常规”设置选项卡上的“链接的框架和库”部分,将磁盘上的 `Carthage/Build` 文件夹中的 `MSGraphMSALAuthProvider.framework` 拖放到此处。 + +5. 在应用程序目标的“生成阶段”设置选项卡上,单击“+”图标并选择“新建运行脚本阶段”。创建指定 Shell 的“运行脚本”(例如:`/bin/sh`),添加下列内容至 Shell 下方脚本区: + + + +```sh + +/usr/local/bin/carthage copy-frameworks + +``` + + + +并添加路径至希望在 “Input Files” 下使用的框架,如: + + + +``` + +$(SRCROOT)/Carthage/Build/iOS/MSGraphMSALAuthProvider.framework + +``` + +此脚本解决通用二进制文件触发的 [App Store 提交 bug](http://www.openradar.me/radar?id=6409498411401216),并保证存档时复制所需的位代码相关文件和 dSYMs。 + + + +调试信息复制至构建产品目录中时,无论何时在断点停止,都能同步堆栈跟踪。这将能够让你在调试程序中逐步完成第三方代码。 + + + +存档应用程序以提交至 App Store 或 TestFlight 时,Xcode 还将复制这些文件至 应用程序的 `.xcarchive` 捆绑包的 dSYMs 子目录中。 + +## 先决条件 + +此库有两个依赖项,它们都有各自的特定用途: + +1. [MSAL](https://github.com/AzureAD/microsoft-authentication-library-for-objc):添加此依赖项的目的是应对所有特定于身份验证的场景。 + +2. [MSGraphClientSDK](https://github.com/microsoftgraph/msgraph-sdk-objc):添加此依赖项的目的是从 MSGraphClientSDK 选取 MSAuthenticationProvider 协议,以便 MSGraphClientSDK 能够与此库进行通信,从而获取所需令牌。 + +因此,为了使用此库,也必须在项目中添加上述两个框架。 + +## 如何使用 + +假设你已完成以上步骤并添加了所需的框架或 Pod,你的项目现在将具备所有必要条件。 + +因此,现在只需按照以下步骤操作: + +1. 根据此处提供的说明 ([MSAL](https://github.com/AzureAD/microsoft-authentication-library-for-objc)) 创建 `MSALPublicClientApplication` 类的实例。请确保按照 MSAL 自述文件中提到的其他步骤来正确创建此实例。它可能如下所示: +``` +NSError *error = nil; +MSALPublicClientApplication *application = +[[MSALPublicClientApplication alloc] initWithClientId:@"" +error:&error]; +``` +2. 创建 `MSALAuthenticationProviderOptions` 的实例,如下所示: +``` +MSALAuthenticationProviderOptions *authProviderOptions= [[MSALAuthenticationProviderOptions alloc] initWithScopes:]; +``` + +3. 使用前面步骤中创建的 `MSALPublicClientApplication` 和 `MSALAuthenticationProviderOptions ` 实例,按以下方式创建 `MSALAuthenticationProvider` 的实例: +``` + MSALAuthenticationProvider *authProvider = [[MSALAuthenticationProvider alloc] initWithPublicClientApplication:publicClientApplication andOptions:authProviderOptions]; +``` +现在便有了一个实例,这个实例遵循 MSAuthenticationProvider 协议,并配置了 MSALPublicClientApplication 实例,可以应对多种身份验证场景。 + + 3. 现在,可以将此 authenticationProvider 与 MSGraphClientSDK 结合使用,从而对 Microsoft Graph 服务器进行经过身份验证的网络调用。请转到[如何使用 MSGraphClientSDK](https://github.com/microsoftgraph/msgraph-sdk-objc#how-to-use-sdk) 了解具体使用方法。 + +现在,你已经万事俱备了。