PowerPointやExcelの資料をアプリに同梱するには？［ユニバーサルWindowsアプリ開発］：WinRT／Metro TIPS
アプリにOfficeドキュメントを同梱し、アプリ内からこれを開く方法と、Windows PCにOfficeがインストールされていない場合に、Office Onlineを使って対処する方法を解説する。
powered by Insider.NET
Windows Phoneには標準でOfficeが搭載されている。ならば、WordやExcelやPowerPointのファイル（以降、Office文書ファイル）をアプリに格納しておいて、アプリから開けないだろうか？ 例えば、操作マニュアルをWordファイルで提供するといった用途が考えられる。そこで本稿では、ユニバーサルWindowsアプリに同梱したOffice文書ファイルをアプリから開く方法と、OfficeがインストールされていないWindows環境での対策を解説する。なお、本稿のサンプルは「Windows Store app samples：MetroTips #79」からダウンロードできる。
事前準備
ユニバーサルプロジェクトを使ってユニバーサルWindowsアプリを開発するには、以下の開発環境が必要である。本稿では、無償のVisual Studio Express 2013 for Windowsを使っている。
- SLAT対応のPC*1
- 2014年4月のアップデート*2適用済みの64bit版Windows 8.1 Pro版以上*3
- Visual Studio 2013 Update 2*4適用済みのVisual Studio 2013（以降、VS 2013）*5
*1 SLAT対応ハードウェアは、Windows Phone 8.1エミュレーターの実行に必要だ。ただし未対応でも、ソースコードのビルドと実機でのデバッグは可能だ。SLAT対応のチェック方法はMSDNブログの「Windows Phone SDK 8.0 ダウンロードポイント と Second Level Address Translation (SLAT) 対応PCかどうかを判定する方法」を参照。なお、SLAT対応ハードウェアであっても、VM上ではエミュレーターが動作しないことがあるのでご注意願いたい。
*2 事前には「Windows 8.1 Update 1」と呼ばれていたアップデート。スタート画面の右上に検索ボタンが（環境によっては電源ボタンも）表示されるようになるので、適用済みかどうかは簡単に見分けられる。ちなみに公式呼称は「the Windows RT 8.1, Windows 8.1, and Windows Server 2012 R2 update that is dated April, 2014」というようである。
*3 Windows Phone 8.1エミュレーターを使用しないのであれば、32bit版のWindows 8.1でよい。
*4 マイクロソフトのダウンロードページから誰でも入手できる。
*5 本稿に掲載したコードを試すだけなら、無償のExpressエディションで構わない。Visual Studio Express 2013 Update 2 for Windows（製品版）はマイクロソフトのページから無償で入手できる。Expressエディションはターゲットプラットフォームごとに製品が分かれていて紛らわしいが、Windowsストアアプリの開発には「for Windows」を使う（「for Windows Desktop」はデスクトップで動作するアプリ用）。
用語
本稿では、紛らわしくない限り次の略称を用いる。
- Windows：Windows 8.1とWindows RT 8.1（2014年4月のアップデートを適用済みのもの）
- Phone：Windows Phone 8.1
サンプルコードについて
Visual Studio 2013 Update 2のRTMがリリースされたが、残念なことに本稿執筆時点ではVB用のユニバーサルプロジェクトのテンプレートがまだ含まれていない*6。そのため、本稿で紹介するコードはC#のユニバーサルプロジェクトだけとさせていただく。別途公開しているサンプルコードには、ユニバーサルプロジェクトに似せた形のVBのコードも含めてある*7。
*6 VB用のユニバーサルプロジェクトも近い将来に提供されるものと思われる。例えば、Windowsストアアプリ用のVBプロジェクトのCommonフォルダーに自動生成される「NavigationHelper.vb」ファイルには、Phoneの［戻る］ボタン（ハードウェアボタン）からの割り込みを処理するためのコードがUpdate 2ですでに追加されている。これはユニバーサルプロジェクトのために必要になるコードであり、ユニバーサルプロジェクトを提供する予定がないのなら不要なものだ。
*7 プロジェクト間のファイルリンクを使えば、VBでもユニバーサルプロジェクトに似たソリューション構成にできる。別途公開のサンプルコードでは、VBでもWindows用／Phone用／共通コードの3プロジェクトに分けてユニバーサルプロジェクトに似せて書いてみた。ただし、このような形にするにはかなりの手間が掛かった（説明するには本連載の1回分では足りないほどだ）。ユニバーサルプロジェクトテンプレートの形にこだわらず、素直に作った方がよさそうである。なお、ユニバーサルプロジェクトで作らなくてもユニバーサルWindowsアプリはリリースできるので、お間違えなきよう（「WinRT／Metro TIPS：ユニバーサルプロジェクトで開発するには？」参照）。
Office文書ファイルをアプリに同梱するには？
プロジェクト内に置いて、「コンテンツ」にすればよい。ユニバーサルプロジェクトの場合は、共有プロジェクトに置ける。
例として適当なPowerPointのファイルを作り、ファイル名を「sample.pptx」とする（ソリューションとは別のフォルダーに作成したとする）。VS 2013のソリューションエクスプローラーで、まず共有プロジェクトに適当なフォルダー（ここでは「Assets」とする）を作る。続いて、作成した「Assets」フォルダーを右クリックして［追加］−［既存の項目］を選び、「sample.pptx」ファイルを指定する。そうしたら、「sample.pptx」ファイルのプロパティで、［ビルド アクション］を「コンテンツ」にする（次の画像）。画像やフォントを同梱するのと同じである。
プロジェクトに追加したOffice文書ファイルを［コンテンツ］にする（VS 2013）
プロジェクトに追加したOffice文書ファイルのプロパティで、［ビルド アクション］を［コンテンツ］にする（赤枠内）。
その下の［出力ディレクトリにコピーする］は、［コピーしない］のままにしておく。
なお、ソリューションエクスプローラーで［追加］−［既存の項目］を選ぶ代わりに、エクスプローラーからファイルをソリューションエクスプローラーのフォルダーにドラッグ＆ドロップしてもよい。
同梱したOffice文書ファイルをアプリから開くには？
LaunchFileAsyncメソッド（Windows.System名前空間のLauncherクラス）を使えばよい。ただし、アプリに同梱したファイルは他のアプリ（ここではPowerPoint）からアクセスできないので、一時フォルダーにコピーしてから開く（デバッグ実行時はインストール場所が違うのでアクセス可能だ。気を付けよう）。
まず、アプリに同梱したファイルを一時フォルダーにコピーするコードは次のようになる。
// アプリに同梱するOfficeファイル
const string SampleFolder = "Assets";
const string SampleFileName = "sample.pptx";
// アプリに同梱したOfficeファイルを一時フォルダーにコピーして、それを返す
private static async System.Threading.Tasks.Task<Windows.Storage.StorageFile>
GetOfficeFileAsync()
{
var tempFolder = Windows.Storage.ApplicationData.Current.TemporaryFolder;
var tempFile = (await tempFolder.TryGetItemAsync(SampleFileName))
as Windows.Storage.StorageFile;
// すでにコピー済みなら、それを返す
if (tempFile != null)
return tempFile;
// 一時フォルダーにコピーしてそのファイルを返す
var installedFolder = Windows.ApplicationModel.Package.Current.InstalledLocation;
var sampleFolder = await installedFolder.GetFolderAsync(SampleFolder);
var srcFile = await sampleFolder.GetFileAsync(SampleFileName);
return await srcFile.CopyAsync(
tempFolder, SampleFileName,
Windows.Storage.NameCollisionOption.ReplaceExisting
);
}
共有プロジェクトに新しく「AttachedOfficeFiles.cs」ファイルを作り、その中の「AttachedOfficeFiles」クラスに記述する。
PhoneにはTryGetItemAsyncメソッドが存在しないため、このままではビルドできない（すぐ次に述べる）。
ただし、PhoneのAPIにはTryGetItemAsyncメソッド（Windows.Storage名前空間のStorageFolderクラス）が存在しないので、新しくStorageFolderExtensionsクラスを作って、そこに拡張メソッドとして実装する（次のコード）。
#if WINDOWS_PHONE_APP
public static class StorageFolderExtensions
{
public static async System.Threading.Tasks.Task<Windows.Storage.IStorageItem>
TryGetItemAsync(this Windows.Storage.StorageFolder folder, string name)
{
var files = await folder.GetItemsAsync().AsTask().ConfigureAwait(false);
return files.FirstOrDefault(p => p.Name == name);
// FirstOrDefaultメソッドの使用には、ファイル冒頭に「using System.Linq;」が必要
}
}
#endif
PhoneのAPIにはTryGetItemAsyncメソッドが存在しないので、自前で実装しなければならない。Phone専用なので「#if」ディレクティブで切り分ける。
この程度の短いクラスなら、既存のファイルに記述してしまってもそれほど混乱しないだろう。ここでは、上記の「AttachedOfficeFiles.cs」ファイルに同居させた。
先のGetOfficeFileAsyncメソッドで得られたファイルを開くコードは次のようだ。
public static async System.Threading.Tasks.Task OpenOfficeDocumentAsync()
{
var officeFile = await GetOfficeFileAsync();
var opt = new Windows.System.LauncherOptions();
await Windows.System.Launcher.LaunchFileAsync(officeFile, opt);
}
GetOfficeFileAsyncメソッドで得られるのはPowerPointのファイルなので、このコードでPowerPointが起動してファイルが開かれる。
ここではLauncherOptionsオブジェクト（＝ローカル変数「opt」）を使っていないが、後ほどOfficeのインストールされていないWindowsへの対処で使用する。
あとは画面にボタンを配置し、そのClickイベントで上述のOpenOfficeDocumentAsyncメソッドを呼び出せば、アプリに同梱したOffice文書ファイルが表示される（次の画像）。OpenOfficeDocumentAsyncメソッドは非同期メソッドなので、ボタンのClickイベントハンドラーにasyncキーワードの追加を忘れずに（次のコード）。
private async void Button_Click(object sender, RoutedEventArgs e)
{
await AttachedOfficeFiles.OpenOfficeDocumentAsync();
}
アプリに同梱したOffice文書ファイルが表示された
上はWindows。デスクトップに切り替わり、PowerPointが立ち上がる。なお、PowerPoint（または、PowerPointのファイルを表示できるアプリ）がインストールされていない環境では表示できないが、その対処は次項で述べる。
下はPhone（VS 2013 Update 2付属のエミュレーター）。Phone版のPowerPointに切り替わる。
OfficeがインストールされていないWindowsでは？
上記のコードは、Office（あるいは、Office文書ファイルを表示するアプリ）がインストールされていないWindowsではうまくいかない（PhoneにはOfficeが標準なので心配はない）。その対策として、同じOffice文書ファイルをOneDriveに置いておき、Office Onlineで開くようにするとよい。
まず、前述の「sample.pptx」ファイルをOneDriveの公開可能なフォルダーにコピーし、［表示のみ可能］にしておく（次の画像）。
OneDriveに置いた「sample.pptx」ファイル（Internet Explorer）
共有範囲は公開だが、他の人には［表示のみ可能］となるフォルダーに置こう（赤枠内）。
アクセス許可の設定は上位のフォルダー単位になる。詳しくは「ファイルとフォルダーを共有しアクセス許可を変更する」を参照してほしい。
なお、アクセス許可の設定を行うにはInternet Explorerを使う。WindowsストアアプリのOneDriveからはできないようである。
続いて、Internet ExplorerでOneDriveに置いた「sample.pptx」ファイルをクリックする（上の画像の画面でクリックする）。すると「PowerPoint Online」に切り替わって、PowerPointのファイルが表示されるので、そのURLをコピーしてどこかにメモしておく（次の画像）。
PowerPoint Onlineで「sample.pptx」ファイルを表示（Internet Explorer）
前の画像で「sample.pptx」ファイルをクリックすると、このようにPowerPoint Onlineで表示される。このときのURLをメモしておく。
この画像では、上部のメニューに［プレゼンテーションの編集］がある（赤枠内）。これは、編集可能なアカウントでサインインしているためだ。サインアウトしてこのメニューが［POWERPOINTで開く］に変わることを確かめておこう（変わらなければ、前述した［表示のみ可能］の設定ができておらず、誰でも編集できる状態だ）。
さて、OfficeがインストールされていないWindowsでは、上記のPowerPoint OnlineのURLを開いてやればよい。そのために利用できるのが、LauncherOptionsオブジェクトのFallbackUriプロパティだ。ファイルの関連付けでは開けなかったとき、FallbackUriプロパティに指定したWebページを自動的に開いてくれるのだ。
前述のOpenOfficeDocumentAsyncメソッドを、次のコードのように変更する。
// OneDriveにアップロードしたOfficeファイルのURL
const string SampleUrl
= "https://onedrive.live.com/view.aspx?cid=1F……省略…31&app=PowerPoint";
public static async System.Threading.Tasks.Task OpenOfficeDocumentAsync()
{
var officeFile = await GetOfficeFileAsync();
var opt = new Windows.System.LauncherOptions();
#if WINDOWS_APP
// 表示できるアプリがインストールされていないときの代替Uri
opt.FallbackUri = new Uri(SampleUrl);
#endif
await Windows.System.Launcher.LaunchFileAsync(officeFile, opt);
}
LauncherOptionsオブジェクト（＝ローカル変数「opt」）のFallbackUriプロパティへの設定を追加した（太字の部分）。定数のSampleUrlには、さきほどメモしておいたURLを記述する。
これで、Officeを表示できるアプリがインストールされていないWindowsでは、ブラウザでPowerPoint Onlineが表示されるようになる。
これで実行してみると、PowerPointがインストールされていないWindowsでは、次の画像のようにPowerPoint Onlineで表示される。なお、厳密にテストするにはPowerPointをアンインストールすべきであろうが、「sample.pptx」ファイル（および、コード内の定数）の拡張子を関連付けのないもの（例えば「.notpptx」など）に変更してしまえば動作を確認できる。
FallbackUriの指定によってPowerPoint Onlineが表示された（Windows）
画面の左半分は本稿で作ったアプリ、右半分はアプリから起動されたInternet Explorerである。
なお、別途公開のサンプルコードのWindowsプロジェクトには、直接PowerPoint Onlineで表示するためのコードも入れてある。
まとめ
PhoneにはOffice ハブが標準だ。これを利用しない手はないだろう。また、OfficeがインストールされていないWindowsでも、OneDriveとPowerPoint Onlineを利用すればOffice文書を表示できる。
ユニバーサルプロジェクトでは、それらのコードを共有プロジェクトに置ける。
なお、本稿では筆者のOneDriveを使ったが、多数のアクセスが見込まれるアプリでは、ユーザーの許可を得た上でユーザーのOneDriveにアップロードした方がよいだろう。
Copyright© Digital Advantage Corp. All Rights Reserved.