Skip to content
This repository was archived by the owner on Apr 18, 2023. It is now read-only.

HB of localized readme files #16

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
111 changes: 111 additions & 0 deletions README-Localized/README-es-es.md
Original file line number Diff line number Diff line change
@@ -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/<latest_release_tag>"

```



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:@"<your-client-id-here>"
error:&error];
```
2. Cree una instancia de `MSALAuthenticationProviderOptions` como se muestra a continuación:
```
MSALAuthenticationProviderOptions *authProviderOptions= [[MSALAuthenticationProviderOptions alloc] initWithScopes:<array-of-scopes-for-which-you-need-access-token>];
```

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.
111 changes: 111 additions & 0 deletions README-Localized/README-fr-fr.md
Original file line number Diff line number Diff line change
@@ -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/<latest_release_tag>"

```



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:@"<your-client-id-here>"
error:&error];
```
2. Créez une instance de `MSALAuthenticationProviderOptions` comme suit :
```
MSALAuthenticationProviderOptions *authProviderOptions= [[MSALAuthenticationProviderOptions alloc] initWithScopes:<array-of-scopes-for-which-you-need-access-token>];
```

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.
111 changes: 111 additions & 0 deletions README-Localized/README-ja-jp.md
Original file line number Diff line number Diff line change
@@ -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/<latest_release_tag>"

```



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:@"<your-client-id-here>"
error:&error];
```
2. 以下のような `MSALAuthenticationProviderOptions` のインスタンスを作成します。
```
MSALAuthenticationProviderOptions *authProviderOptions= [[MSALAuthenticationProviderOptions alloc] initWithScopes:<array-of-scopes-for-which-you-need-access-token>];
```

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)」に進み、使用方法を確認してください。

ここまでで、すべての準備および実行が完了しているはずです。
Loading