diff --git a/loc/README-ja.md b/loc/README-ja.md index 74e8b28..95c5375 100644 --- a/loc/README-ja.md +++ b/loc/README-ja.md @@ -1,4 +1,4 @@ -#iOS# 版 Office 365 Connect アプリ +#iOS# 版 Office 365 Connect アプリ# [日本 (日本語)](/loc/README-ja.md) (日本語) @@ -9,24 +9,22 @@ Office 365 への接続は、各 iOS アプリが Office 365 によって提供 **目次** * [環境を設定する](#set-up-your-environment) -* [CocoaPods を使用して Office 365 iOS SDK をインポートする](#use-cocoapods-to-import-the-o365-ios-sdk) +* [CocoaPods を使用して O365 iOS SDK をインポートする](#use-cocoapods-to-import-the-o365-ios-sdk) * [Microsoft Azure にアプリを登録する](#register-your-app-with-microsoft-azure) * [プロジェクトにクライアント ID とリダイレクト URI を取り込む](#get-the-client-id-and-redirect-uri-into-the-project) * [目的のコード](#code-of-interest) -* [質問とコメント](#questions-and-comments) * [トラブルシューティング](#troubleshooting) -* [その他の技術情報](#additional-resources) +* [その他のリソース](#additional-resources) -## 環境を設定する ## +## 環境を設定する ## iOS 版 Office 365 Connect アプリを実行するには、以下が必要です。 -* - Apple 社の [Xcode](https://developer.apple.com/)。 -* Office 365 アカウント。Office 365 アカウントは、[Office 365 開発者向けサイト](http://msdn.microsoft.com/ja-jp/library/office/fp179924.aspx)にサインアップすると取得できます。これにより、Office 365 のデータを対象とするアプリの作成に使用できる API にアクセスできるようになります。 +* Apple 社の [Xcode](https://developer.apple.com/)。 +* Office 365 アカウント。Office 365 アカウントは、[Office 365 開発者向けサイト](http://msdn.microsoft.com/library/office/fp179924.aspx)にサインアップすると取得できます。これにより、Office 365 のデータを対象とするアプリの作成に使用できる API にアクセスできるようになります。 * アプリケーションを登録する Microsoft Azure テナント。Azure Active Directory は、アプリケーションが認証と承認に使用する ID サービスを提供します。試用版のサブスクリプションを作成し、O365 アカウントに関連付ける方法の詳細については、「[Office 365 の開発環境を設定](https://msdn.microsoft.com/office/office365/howto/setup-development-environment)」および 「**新しい Azure サブスクリプションを作成し、Office 365 アカウントに関連付ける**」のセクションを参照してください。 **重要事項**:Azure サブスクリプションが既ある場合、Office 365 アカウントにそのサブスクリプションをバインドする必要があります。この工程の詳細については、「[Office 365 の開発環境を設定する](https://msdn.microsoft.com/office/office365/howto/setup-development-environment)」 および「 **Office 365 アカウントを Azure AD と関連付けてアプリを作成および管理する**」のセクションを参照してください。 @@ -41,7 +39,7 @@ Office 365 アカウント、および Office 365 開発者サイトにバイン 3. Azure アプリの登録固有の情報 (ClientID と RedirectUri) を、Office 365 Connect アプリに入力します。 -## CocoaPods を使用して Office 365 iOS SDK をインポートする +## CocoaPods を使用して Office 365 iOS SDK をインポートする 注:依存関係マネージャーとして **CocoaPods** を初めて使用する場合は、これをインストールしてからプロジェクトで Office 365 iOS SDK の依存関係を取り込む必要があります。インストール済みの場合は、この手順を省略して「**プロジェクトに iOS 版 Office 365 SDK の依存関係を取り込む**」に移動しても構いません。 Mac の**ターミナル** アプリケーションから、次のコード行を入力します。 @@ -52,16 +50,15 @@ Mac の**ターミナル** アプリケーションから、次のコード行 インストールとセットアップが成功すると、「**ターミナルのセットアップが完了しました**」というメッセージが表示されます。CocoaPods とその使用法の詳細については、「[CocoaPods](https://cocoapods.org/)」を参照してください。 -**プロジェクトに iOS 版 Office 365 SDK の依存関係を取り込む** -Office 365 iOS Connect アプリには、プロジェクトに Office 365 と ADAL のコンポーネント (pods) を取り込む podfile がすでに含まれています。podfile の場所は、サンプルの設定 (「Podfile」) に基づき、**objective-c** または **swift** のいずれかのフォルダーにあります。次の例は、このファイルの内容を示しています。 +**プロジェクトに iOS 版 Office 365 SDK の依存関係を取り込む** Office 365 iOS Connect アプリには、プロジェクトに Office 365 と ADAL のコンポーネント (pods) を取り込む podfile がすでに含まれています。podfile の場所は、サンプルの設定 (「Podfile」) に基づき、**objective-c** または **swift** のいずれかのフォルダーにあります。次の例は、このファイルの内容を示しています。 - target ‘test’ do + target ‘test’ do pod 'ADALiOS', '~> 1.2.1' pod 'Office365/Outlook', '= 0.9.1' pod 'Office365/Discovery', '= 0.9.1' - end + end **Terminal** (プロジェクト フォルダーのルート) にあるプロジェクトのディレクトリに移動して、次のコマンドを実行する必要があります。 @@ -72,22 +69,22 @@ Office 365 iOS Connect アプリには、プロジェクトに Office 365 と AD 注: これらの依存関係がプロジェクトに追加されたことを示す確認のメッセージを受信します。Podfile に構文エラーがあると、インストール コマンドを実行する際にエラーが発生します。 -## Microsoft Azure にアプリを登録する -1. Azure AD 資格情報を使用して、[Azure 管理ポータル](https://manage.windowsazure.com)にサインインします。 -2. 左側のメニューで **[Active Directory]** をクリックしてから、Office 365 開発者向けサイトのディレクトリをクリックします。 -3. 上部のメニューで、**[アプリケーション]** をクリックします。 -4. 下部のメニューから、**[追加]** をクリックします。 -5. **[何を行いますか] ページ**で、**[所属組織が開発しているアプリケーションの追加]** をクリックします。 -6. **[アプリケーションについてお聞かせください]** ページで、アプリケーション名には「**O365-iOS-Connect**」を指定し、種類は「**ネイティブ クライアント アプリケーション**」を選択します。 -7. ページの右下隅にある矢印アイコンをクリックします。 -8. [アプリケーション情報] ページで、リダイレクト URI を指定します。この例では http://localhost/connect を指定します。続いて、ページの右下隅にあるチェック ボックスをクリックします。この値は、「**プロジェクトに ClientID と RedirectUri を取り込む**」セクションで使用するため覚えておいてください。 -9. アプリケーションが正常に追加されたら、アプリケーションの [クイック スタート] ページに移動します。ここで、上部のメニューにある [構成] をクリックします。 -10. **[他のアプリケーションへのアクセス許可]** で、次のアクセス許可を追加します。**Office 365 Exchange Online** アプリケーションを追加します。次に、アプリケーションを追加するために、右下隅のチェック ボックスをクリックします。最後に、**[他のアプリケーションへのアクセス許可]** セクションに戻り、**[委任されたアクセス許可]** から **[ユーザーとしてメールを送信]** を選択してください。 -13. **[構成]** ページで、**[クライアント ID]** に指定された値をコピーします。この値は、「**プロジェクトに ClientID と RedirectUri を取り込む**」セクションで使用するため覚えておいてください。 -14. 下部のメニューで、**[保存]** をクリックします。 +## Microsoft Azure にアプリを登録する +1. Azure AD 資格情報を使用して、[Azure 管理ポータル](https://manage.windowsazure.com)にサインインします。 +2. 左側のメニューで **[Active Directory]** をクリックしてから、Office 365 開発者向けサイトのディレクトリをクリックします。 +3. 上部のメニューで、**[アプリケーション]** をクリックします。 +4. 下部のメニューから、**[追加]** をクリックします。 +5. **[何を行いますか] ページ**で、**[所属組織が開発しているアプリケーションの追加]** をクリックします。 +6. **[アプリケーションについてお聞かせください]** ページで、アプリケーション名には「**O365-iOS-Connect**」を指定し、種類は「**ネイティブ クライアント アプリケーション**」を選択します。 +7. ページの右下隅にある矢印アイコンをクリックします。 +8. [アプリケーション情報] ページで、リダイレクト URI を指定します。この例では http://localhost/connect を指定します。続いて、ページの右下隅にあるチェック ボックスをクリックします。この値は、「**プロジェクトに ClientID と RedirectUri を取り込む**」セクションで使用するため覚えておいてください。 +9. アプリケーションが正常に追加されたら、アプリケーションの [クイック スタート] ページに移動します。ここで、上部のメニューにある [構成] をクリックします。 +10. **[他のアプリケーションへのアクセス許可]** で、次のアクセス許可を追加します。**Office 365 Exchange Online** アプリケーションを追加します。次に、アプリケーションを追加するために、右下隅のチェック ボックスをクリックします。最後に、**[他のアプリケーションへのアクセス許可]** セクションに戻り、**[委任されたアクセス許可]** から **[ユーザーとしてメールを送信]** を選択してください。 +13. **[構成]** ページで、**[クライアント ID]** に指定された値をコピーします。この値は、「**プロジェクトに ClientID と RedirectUri を取り込む**」セクションで使用するため覚えておいてください。 +14. 下部のメニューで、**[保存]** をクリックします。 -## クライアント ID を取得して、URI をプロジェクトにリダイレクトする +## クライアント ID を取得して、URI をプロジェクトにリダイレクトする 最後に、前のセクション「**Microsoft Azure にアプリを登録する**」で記録したクライアント ID とリダイレクト URI を追加する必要があります。 @@ -102,11 +99,11 @@ Office 365 iOS Connect アプリには、プロジェクトに Office 365 と AD -## 目的のコード +## 目的のコード **Azure AD での認証** -Azure AD での認証 (これにはアクセス トークンの取得と管理が含まれます) 用のコードは、AuthenticationManager にあります。 +アクセス トークンの取得と管理が含まれる Azure AD での認証用のコードは、AuthenticationManager にあります。 **Outlook サービス クライアント** @@ -124,13 +121,9 @@ Office 365 探索サービスを使用して Exchange サービスのエンド メールを送信する操作のコードは、SendMailViewController の sendMailMessage メソッドにあります。 - -## 質問とコメント - -iOS 版 Office 365 のサンプルについて、Microsoft にフィードバックをお寄せください。フィードバックは、このリポジトリの「[問題](https://github.com/OfficeDev/O365-iOS-Connect)」セクションに送信できます。
Office 365 の開発全般については、 「[スタックオーバーフロー](http://stackoverflow.com/questions/tagged/Office365+API)」に送信してください。質問には、必ず [Office365] および [API] のタグを付けてください。 -## トラブルシューティング +## トラブルシューティング Xcode 7.0 のアップデートにより、iOS 9 を実行するシミュレーターやデバイス用に App Transport Security を使用できるようになりました。「[App Transport Security のテクニカル ノート](https://developer.apple.com/library/prerelease/ios/technotes/App-Transport-Security-Technote/)」を参照してください。 @@ -141,7 +134,7 @@ Xcode 7.0 のアップデートにより、iOS 9 を実行するシミュレー これらの例外が含まれていないと、Xcode で iOS 9 シミュレーターにデプロイされたときに、このアプリで Office 365 API へのすべての呼び出しが失敗します。 -## その他の技術情報 +## 追加リソース * [iOS 用 Office 365 コード スニペット](https://github.com/OfficeDev/O365-iOS-Snippets) * [iOS 用 Office 365 プロファイル サンプル](https://github.com/OfficeDev/O365-iOS-Profile) @@ -150,6 +143,5 @@ Xcode 7.0 のアップデートにより、iOS 9 を実行するシミュレー * [ファイルの REST 操作のリファレンス](http://msdn.microsoft.com/office/office365/api/files-rest-operations) * [予定表の REST 操作のリファレンス](http://msdn.microsoft.com/office/office365/api/calendar-rest-operations) * [Office デベロッパー センター](http://dev.office.com/) -* [Office 365 API のサンプル コードとビデオ](https://msdn.microsoft.com/office/office365/howto/starter-projects-and-code-samples) - +* [Office 365 API のコード サンプルとビデオ](https://msdn.microsoft.com/office/office365/howto/starter-projects-and-code-samples)