HB of localized readme files

README-Localized/README-es-es.md

@@ -0,0 +1,164 @@
+
+# SDK de Microsoft Graph para ObjC
+
+
+¡Introducción al SDK de Microsoft Graph para ObjectiveC al integrarlo en sus aplicaciones para iOS y MacOS!
+
+## 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 'MSGraphClientSDK'
+  ```
+
+
+### 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 MSGraphClientSDK para este proyecto en Github.
+
+
+
+```
+
+github "microsoftgraph/msgraph-sdk-objc" "tags/<latest_release_tag>"
+
+```
+
+
+
+3. Ejecute `carthage update`. Esto recuperará las dependencias en una carpeta `Carthage/Checkouts` y después, compilará la biblioteca MSGraphClientSDK.
+
+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 `MSGraphClientSDK.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/MSGraphClientSDK.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
+
+Se debe autenticar cada llamada de red a Microsoft Graph. Por ese motivo, la creación de una instancia de MSHTTPClient toma una instancia del protocolo de MSAuthenticationProvider como parámetro.
+
+Puede crear la instancia de MSAuthenticationProvider de dos maneras:
+
+### Usando [MSGraphMSALAuthProvider](https://github.com/microsoftgraph/msgraph-sdk-objc-auth)
+
+Este repositorio administra los escenarios de autenticación mediante [MSAL](https://github.com/AzureAD/microsoft-authentication-library-for-objc)
+
+### Escribiendo su propia implementación de MSAuthenticationProvider
+
+También puede elegir administrar la autenticación por cualquier otro medio que se adapte a sus necesidades. Debe seguir los siguientes pasos para que este SDK pueda interactuar con el mecanismo de autenticación.
+
+1. Luego de integrar el SDK, tendrá que proporcionar la implementación para MSAuthenticationProvider creando un archivo nuevo.
+
+2. En este archivo, escriba una implementación para el siguiente método de MSAuthenticationProvider
+
+```
+
+- (void) getAccessTokenWithCompletion:(void (^)(NSString *accessToken, NSError *error))completion;
+
+```
+
+Esta implementación debe poder comunicarse con el mecanismo de autenticación para obtener el token de acceso o cualquier error que se haya producido durante el proceso y devolverlo en el bloque de finalización.
+
+## Cómo se usa SDK
+
+
+
+Suponiendo que ha realizado los pasos anteriores, ahora tendrá:
+
+
+
+1. Un archivo .xcworkspace integrado con el pod de MSGraphClientSDK o un MSGraphClientSDK.framework integrado con el proyecto. 
+
+
+
+2. Instancia de una clase que implementa el protocolo MSAuthenticationProvider.
+
+
+
+Luego de los pasos anteriores, debe seguir los siguientes pasos:
+
+
+
+1. Cree una instancia de MSHTTPClient desde MSClientFactory de la siguiente forma:
+
+```
+
+MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];
+
+```
+
+2. Configure un objeto de solicitud nativa que puede ser similar al que sigue:
+
+```
+
+NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/me"]]];
+
+```
+
+3. Cree un objeto MSURLSessionTask (para nuestro ejemplo un DataTask) con la ayuda de MSHTTPClient de la forma siguiente y llame a execute en él:
+
+```
+
+MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest
+
+completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
+
+// Hacer algo
+
+}];
+
+[meDataTask execute];
+
+```
+
+
+
+Y eso es todo. Ahora ha llamado correctamente a un servidor Graph solicitando información sobre el usuario.
+
+## Recursos de uso
+
+* [Procesamiento por lotes](/Docs/Content/Batching.md)
+* [Iterador de páginas](/Docs/Tasks/PageIterator.md)
+* [Tarea de carga de archivos de gran tamaño](/Docs/Tasks/LargeFileUpload.md)

README-Localized/README-fr-fr.md

@@ -0,0 +1,164 @@
+
+# Kit de développement logiciel Microsoft Graph pour ObjC
+
+
+Commencez à utiliser le kit de développement logiciel (SDK) Microsoft Graph pour ObjectiveC en l’intégrant dans vos applications iOS et MacOS !
+
+## 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 'MSGraphClientSDK'
+  ```
+
+
+### 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 MSGraphClientSDK pour ce projet sur GitHub.
+
+
+
+```
+
+github "microsoftgraph/msgraph-sdk-objc" "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 MSGraphClientSDK.
+
+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 `MSGraphClientSDK.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/MSGraphClientSDK.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
+
+Chaque appel réseau à Microsoft Graph doit être authentifié. À cet effet, la création d’une instance de MSHTTPClient prend l’instance d’un protocole MSAuthenticationProvider comme paramètre.
+
+Vous pouvez créer l’instance MSAuthenticationProvider à l’aide des deux méthodes suivantes :
+
+### Utilisation de [MSGraphMSALAuthProvider](https://github.com/microsoftgraph/msgraph-sdk-objc-auth)
+
+Ce repo gère les scénarios d’authentification via [MSAL](https://github.com/AzureAD/microsoft-authentication-library-for-objc)
+
+### En écrivant votre propre implémentation de MSAuthenticationProvider
+
+Vous pouvez également choisir de gérer l’authentification à l’aide de n’importe quel moyen répondant à vos besoins. Vous devez suivre les étapes ci-dessous pour que ce SDK puisse interagir avec votre mécanisme d’authentification.
+
+1. Une fois le kit de développement logiciel (SDK) intégré, vous devez fournir l’implémentation pour MSAuthenticationProvider en créant un nouveau fichier.
+
+2. Dans ce fichier, écrivez une implémentation pour la méthode MSAuthenticationProvider
+
+```
+
+- (void) getAccessTokenWithCompletion:(void (^)(NSString *accessToken, NSError *error))completion;
+
+```
+
+Cette implémentation doit être en mesure de parler à votre mécanisme d’authentification afin d’obtenir le jeton d’accès ou toute erreur qui s’est produite pendant le processus et de le renvoyer dans le bloc d’achèvement.
+
+## Utiliser le kit de développement logiciel
+
+
+
+En supposant que vous avez suivi les étapes ci-dessus, vous disposez désormais des éléments suivants :
+
+
+
+1. Fichier. xcworkspace intégré avec pod MSGraphClientSDK ou MSGraphClientSDK.framework intégré à votre projet. 
+
+
+
+2. Instance d’une classe implémentant le protocole MSAuthenticationProvider.
+
+
+
+Une fois les étapes précédentes effectuées, vous devez suivre les étapes ci-dessous :
+
+
+
+1. Créez une instance de MSHTTPClient à partir de MSClientFactory en procédant de la manière suivante :
+
+```
+
+MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];
+
+```
+
+2. Configurez un objet de demande native qui peut ressembler à ceci :
+
+```
+
+NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/me"]]];
+
+```
+
+3. Créez une MSURLSessionTask (dans notre exemple, un DataTask) avec l’aide d’MSHTTPClient comme ci-dessous et appelez exécuter sur celle-ci :
+
+```
+
+MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest
+
+completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
+
+//Do something
+
+}];
+
+[meDataTask execute];
+
+```
+
+
+
+Et voilà. Vous avez désormais créé un appel à Graph Server qui demande des informations sur l’utilisateur.
+
+## Ressources d’utilisation
+
+* [Traitement par lots](/Docs/Content/Batching.md)
+* [Itérateur de page](/Docs/Tasks/PageIterator.md)
+* [Tâche de chargement d’un fichier volumineux](/Docs/Tasks/LargeFileUpload.md)