ClickOnce 配置の固有のエラーのトラブルシューティング
適用対象: Visual Studio
この記事では、ClickOnce アプリケーションを配置するときに発生する可能性がある一般的なエラーについて説明し、各問題を解決する手順について説明します。
一般エラー
アプリケーション ファイルを検索しようとしても、Internet Explorer で何も実行されないか、XML が表示される、あるいは [実行] または [名前を付けて保存] ダイアログ ボックスが表示される
このエラーの原因として考えられるのは、コンテンツ タイプ (MIME タイプとも呼ばれます) がサーバーまたはクライアントに正しく登録されていないことです。
まず、 .application 拡張機能をコンテンツ タイプ "application/x-ms-application" に関連付けるためにサーバーが構成されていることを確認します。
サーバーが正しく構成されている場合は、.NET Framework 2.0 がコンピューターにインストールされていることを確認します。 .NET Framework 2.0 がインストールされていて、この問題が引き続き発生する場合は、.NET Framework 2.0 をアンインストールして再インストールして、コンテンツ タイプをクライアントに再登録してみてください。
エラー: "アプリケーションを取得できません。 Files missing in deployment" (アプリケーションを取得できません。ファイルが配置にありません) または "Application download has been interrupted, check for network errors and try again later" (アプリケーションのダウンロードが中断されました。ネットワークエラーを確認し、後でもう一度お試しください)
このメッセージは、ClickOnce マニフェストが参照する 1 つ以上のファイルをダウンロードできないことを示します。 このエラーをデバッグする最も簡単な方法は、ClickOnce がダウンロードできないと言う URL をダウンロードしてみます。 考えられるいくつかの原因を次に示します。
- ログ ファイルに "(403) Forbidden" または "(404) Not found" と表示されている場合は、Web サーバーがこのファイルのダウンロードをブロックしないように構成されていることを確認します。 詳細については、「ClickOnce 配置でのサーバーおよびクライアント構成の問題」を参照してください。
- .config ファイルがサーバーによってブロックされている場合は、.config ファイルを含む ClickOnce アプリケーションをインストールしようとしたときにダウンロード エラーが発生するを参照してください。
- 配置マニフェストの
deploymentProvider
の URL でアクティブ化に使用された URL とは異なる場所が参照されているためにこのエラーが発生したかどうかを確認します。 - すべてのファイルがサーバー上に存在することを確認します。ClickOnce ログには、見つからなかったファイルが表示されます。
- ネットワーク接続に問題があるかどうかを確認します。ダウンロード中にクライアント コンピューターがオフラインになった場合、このメッセージを受け取る可能性があります。
.config ファイルを含む ClickOnce アプリケーションをインストールしようとしたときのダウンロード エラー
既定では、Visual Basic Windows ベースのアプリケーションには、 App.config ファイルが含まれています。 Windows Server 2003 を使用する Web サーバーからインストールしようとすると、セキュリティ上の理由からオペレーティング システムによって .config ファイルのインストールがブロックされるため、問題が発生する可能性があります。 .config ファイルをインストールできるようにするには、[Publish オプション] ダイアログ ボックスで [.deploy] ファイル拡張子を使用を選択します。
また、 .application、 .manifest、 .deploy ファイルに適切にコンテンツ タイプ (MIME タイプとも呼ばれます) を設定する必要があります。 詳細については、お使いの Web サーバーのドキュメントを参照してください。
詳細については、「 Windows Server: ロックダウン コンテンツ タイプ」を参照してください。
エラー: アプリケーションの形式が正しくありません。ログ ファイルに "XML 署名が無効です" が含まれています
マニフェスト ファイルを更新し、再度署名したことを確認します。 Visual Studio を使用してアプリケーションを再発行するか、Mage を使用してアプリケーションに再度署名します。
サーバー上でアプリケーションを更新しましたが、クライアントは更新プログラムをダウンロードしません
この問題は、次のいずれかのタスクを完了することで解決できる場合があります。
- 配置マニフェストで
deploymentProvider
の URL を調べます。deploymentProvider
が指しているのと同じ場所にあるビットを更新していることを確認します。 - 配置マニフェストで更新間隔を確認します。 この間隔が定期的な間隔 (6 時間に 1 回など) に設定されている場合、ClickOnce は、この間隔が経過するまで更新プログラムをスキャンしません。 アプリケーションが起動するたびに更新プログラムをスキャンするよう、マニフェストを変更することができます。 更新間隔の変更は、開発時に更新プログラムがインストールされていることを確認するための便利なオプションですが、アプリケーションのアクティブ化の速度が低下します。
- [スタート] メニューでもう一度アプリケーションを起動してみてください。 ClickOnce によりバックグラウンドで更新プログラムが検出されている可能性がありますが、インストールを求めるメッセージは次のアクティブ化のときに表示されます。
更新中に、"配置内の参照がアプリケーション マニフェストで定義されている ID と一致しません" というログ エントリを含むエラーが表示されます。
このエラーは、配置マニフェストとアプリケーション マニフェストを手動で編集し、1 つのマニフェスト内のアセンブリの ID の説明がもう一方のマニフェストと同期しなくなったために発生する可能性があります。 アセンブリの ID は、その名前、バージョン、カルチャ、公開キー トークンで構成されます。 マニフェストで ID の説明を調べて、相違を修正してください。
ローカル ディスクまたは CD-ROM からの最初のアクティブ化は成功しますが、以降の [スタート] メニューからのアクティブ化は成功しません
ClickOnce では、アプリケーションの更新プログラムを受け取るために、配置プロバイダーの URL が使用されています。 URL が示している場所が正しいことを確認します。
エラー: アプリケーションを起動できません
このエラー メッセージは、通常、ClickOnce ストアにこのアプリケーションをインストールするときに問題が発生したことを示します。 アプリケーションでエラーが発生したか、ストアが破損しています。 ログ ファイルを見ると、エラーの発生箇所がわかる場合があります。
この問題を解決するには、次の手順に従ってください。
- 配置マニフェストの ID、アプリケーション マニフェストの ID、メイン アプリケーション EXE の ID がすべて一意であることを確認します。
- ファイル パスが 100 文字を超えないことを確認します。 アプリケーションに含まれるファイル パスが長すぎる場合は、格納できる最大パスの制限を超えている可能性があります。 パスを短くしてから、再インストールしてください。
アプリケーション構成ファイルの PrivatePath 設定は受け入れられません
PrivatePath (Fusion プローブ パス) を使用するには、アプリケーションで完全な信頼のアクセス許可を要求する必要があります。 完全な信頼を要求するようにアプリケーション マニフェストを変更してから、再試行してください。
アンインストール中に 次のようなメッセージが表示される: "アプリケーションのアンインストールに失敗しました"
このメッセージは、通常、アプリケーションが既に削除されているか、ストアが破損していることを示します。 OKを選択すると、Add/Remove Program エントリが削除されます。
インストール中に、プラットフォームの依存関係がインストールされていないことを示すメッセージが表示されます
アプリケーションを実行するために必要な GAC (グローバル アセンブリ キャッシュ) に前提条件がありません。
Visual Studio での発行
Visual Studio での発行が失敗する
対象のサーバーに発行する権限があることを確認します。 たとえば、管理者ではなく通常のユーザーとしてターミナル サーバー コンピューターにログインしている場合、ローカル Web サーバーに発行するために必要な権限がない可能性があります。
URL を使用して発行する場合は、対象のコンピューターで FrontPage Server 拡張機能が有効になっていることを確認します。
エラー: Web サイト '<site>' を作成できません。 FrontPage Server 拡張機能と通信するためのコンポーネントがインストールされていません
発行元のコンピューターに Microsoft Visual Studio Web オーサリング コンポーネントがインストールされていることを確認します。 Express ユーザーの場合、このコンポーネントは既定ではインストールされません。
エラー: ファイル 'Microsoft.Windows.Common-Controls, Version=6.0.0.0, Culture=*, PublicKeyToken=6595b64144ccf1df, ProcessorArchitecture=*, Type=win32' が見つかりませんでした
このエラー メッセージは、Visual スタイルを有効にして WPF アプリケーションを発行しようとすると表示されます。 この問題を解決するには、「方法: Visual スタイルが有効になっている WPF アプリケーションを公開する」を参照してください。
Mage の使用
証明書ストアの証明書を使用して署名しようとしたら、空のメッセージ ボックスを受け取った
[署名] ダイアログ ボックスで、次のことを行う必要があります。
- 保存されている証明書で署名を選択します。
- 一覧から証明書を選択します。最初の証明書は既定の選択ではありません。
[Don't Sign]\(署名しない\) ボタンをクリックすると、例外が発生する
この問題は既知のバグです。 すべての ClickOnce マニフェストに署名する必要があります。 いずれかの署名オプションを選択し、 OKを選択します。
その他のエラー
次の表では、クライアント コンピューターのユーザーが ClickOnce アプリケーションをインストールするときに受け取る可能性のある一般的なエラー メッセージを示します。 各エラー メッセージと共に、最も可能性の高いエラーの原因の説明も示します。
エラー メッセージ | 説明 |
---|---|
アプリケーションを起動できません。 アプリケーションの発行元に問い合わせてください。 アプリケーションを起動できません。 サポートが必要な場合はアプリケーションのベンダーにお問い合わせください。 |
これらは、アプリケーションを起動できず、その他の特定の理由が見つからない場合に発生する、一般的なエラー メッセージです。 多くの場合、アプリケーションが破損しているか、ClickOnce ストアが破損していることを意味します。 |
続行できません。 アプリケーションは正しくフォーマットされていません。 サポートが必要な場合はアプリケーションの発行元にお問い合わせください。 アプリケーションの検証に失敗しました。 続行できません。 アプリケーション ファイルを取得できません。 配置に壊れているファイルがあります。 |
配置内のいずれかのマニフェスト ファイルの構文が正しくありません。または、対応するファイルと照合できないハッシュが含まれています。 このエラーは、アセンブリ内に埋め込まれているマニフェストが破損していることを示している場合もあります。 配置を再作成してアプリケーションを再コンパイルするか、手作業によりマニフェストでエラーを見つけて修正します。 |
アプリケーションを取得できません。 認証エラーです。 アプリケーションのインストールに失敗しました。 サーバー上にアプリケーション ファイルが見つかりません。 アプリケーションの発行元または管理者に問い合わせてください。 |
展開内の 1 つ以上のファイルにアクセスするアクセス許可がないため、ダウンロードできません。 これは、Web サーバーから 403 禁止エラーが返されたことが原因である可能性があります。これは、配置内のいずれかのファイルが、Web サーバーによって保護されたファイルとして扱われる拡張子で終わっている場合に発生することがあります。 また、アプリケーションのファイルが含まれているディレクトリにアクセスするために、ユーザー名とパスワードが必要である可能性があります。 |
アプリケーションをダウンロードできません。 アプリケーションに必要なファイルが不足しています。 アプリケーションのベンダーまたはシステム管理者に問い合わせてください。 | アプリケーション マニフェストに列記されている 1 つ以上のファイルがサーバーに見つかりません。 デプロイの依存ファイルをすべてアップロードしたことを確認し、もう一度やり直してください。 |
アプリケーションのダウンロードに失敗しました。 ネットワーク接続を確認するか、システム管理者またはネットワーク サービス プロバイダーに問い合わせてください。 | ClickOnce は、サーバーへのネットワーク接続を確立できません。 サーバーが利用可能かどうか、およびネットワークの状態を確認します。 |
URLDownloadToCacheFile に失敗しました。HRESULT: '<number>'。 '<file>' をダウンロードしようとしてエラーが発生しました。 | ユーザーが展開ターゲット コンピューターで Internet Explorer の [セキュリティで保護されたモードとセキュリティで保護されていないモードの間で変更する場合に警告する] オプションを設定し、インストールされている ClickOnce アプリケーションのセットアップ URL がセキュリティで保護されていないサイト (またはその逆) にリダイレクトされた場合、Internet Explorer の警告によって割り込まれるため、インストールは失敗します。 このエラーを解決するには、次のいずれかのタスクを行います。 - セキュリティ オプションをオフにします。 - セットアップ URL が、セキュリティ モードを変更するような方法でリダイレクトされていないことを確認します。 - リダイレクトを完全に削除し、実際のセットアップ URL をポイントします。 |
ハード ディスクへの書き込み中にエラーが発生しました。 ディスクに十分な空き領域がない可能性があります。 アプリケーションのベンダーまたはシステム管理者に問い合わせてください。 | これは、アプリケーションを格納するためのディスク領域が不足していることを示している可能性がありますが、アプリケーション ファイルをドライブに保存しようとすると、より一般的な I/O エラーを示している可能性もあります。 |
アプリケーションを起動できません。 ディスクに十分な空き領域がありません。 | ハード ディスクがいっぱいです。 領域をクリアしてから、アプリケーションをもう一度実行してください。 |
同時に読み込みを試行している、配置されたライセンス認証の数が多すぎます。 | ClickOnce により、同時に開始できる異なるアプリケーションの数が制限されています。 これは、主に、ローカル環境の ClickOnce サービスに対するサービス拒否攻撃を防ぐために役立ちます。同じアプリケーションを短時間に何度も起動しようとするユーザーには、アプリケーションのインスタンスが 1 つだけ提供されます。 |
Shortcuts cannot be activated over the network. (ネットワーク経由でショートカットをアクティブ化することはできません。) | ClickOnce アプリケーションへのショートカットは、ローカル ハード ディスク上でのみ開始できます。 リモート サーバー上のショートカット ファイルを指す URL を開くことによって、開始することはできません。 |
アプリケーションは大きすぎて、一部の信頼が与えられた状態でオンラインで実行することはできません。 アプリケーションのベンダーまたはシステム管理者に問い合わせてください。 | 部分信頼で実行されるアプリケーションは、オンライン アプリケーション クォータのサイズの半分 (既定では 250 MB) より大きくすることはできません。 |