- 何が起きたか、問題が発生した時どんな操作をしていたか、それが問題であると考える理由、などを提供してください。
- エラーメッセージが表示されたら、そのエラーメッセージの内容（または概略）を記述してください。
- 具体的な表現を用い、曖昧な言葉や口語表現の使用を避けてください。
例えば、"looks bad"「悪いようだ」、“has issues"「問題がある」、“is odd"「変だ」、“is wrong"「間違っている」、“is acting up"「調子が悪い」、“is failing"「失敗している」など抽象的な表現を使用する代わりに、 簡潔に「何がどのように見えるのか」、「どのように動作するのか」、「なぜ問題であると考えるのか」について説明的に記述してください。また、問題が発生した時に表示されるエラーメッセージも記載してください。
例1：
説明が不十分な記述：
When printing, nothing happens. Application doesn't work.
（印刷しても何も起こらない。アプリケーションが動作しない。）
具体的な記述：
Print Menu item enabled, print dialog box appears, print button enabled, but progress dialog box doesn't appear.
（プリントメニュー項目は使用でき、プリントダイアログボックスが表示されて、プリントボタンは使用できるが、進行状況を示すダイアログボックスが表示されない。）
例2：
説明が不十分な記述：
Safari is slow.
（Safari が遅い。）
具体的な記述：
Safari is slow allocating JavaScript arrays. (Also provide a Shark sample and sample JavaScript)
（Safariが JavaScript の配列を割り当てるのに時間がかかる。）（SharkサンプルコードおよびJavaScriptサンプルも提供。）
3.1 : System Profiler report (.spx file)（システムプロファイラ・レポート）：
詳細なシステムプロファイラ・レポートを得るには、アップルメニューから「この Mac について」を選択し、「詳しい情報...」ボタンをクリックしてください。 自動的に「システムプロファイラ」アプリケーションが起動します。「システムプロファイラ」メニュー項目の「ファイル」から「別名で保存...」を選択して、以下のファイルフォーマットを選択してシステムプロファイラ・レポートを保存してください。
ファイルフォーマット：システムプロファイラ 4.0 (XML)
ご注意：詳細なシステムプロファイラ・レポートは、ユーザのハードウェア構成（ドライブ、オーディオ、Bluetooth、グラフィックス、外部ハードウェア情報など）、ネットワーク構成（ワイヤレス、ファイアウォール、動作中のネットワーク、内蔵モデムとボリューム情報などを含む）、ソフトウェア構成（インストールされているアプリケーション、機能拡張、フォント、フレームワーク、環境設定パネル、アクセス・ログ、コンソール・ログ、エラー・ログ、インストール・ログ、メール・ログ、ソフトウェア・アップデート・ログ、システム・ログなど各ファイルを含む） について重要な情報を提供します。
3.2 : Crashing Issues（クラッシュする問題）：
クラッシュが起きた場合は、クラッシュ・ログが不可欠です。Tiger (10.4)でクラッシュ・ログを探すには、以下のディレクトリを確認してください：
[~]/Library/Logs/CrashReporter
上記ディレクトリでクラッシュレポート情報が見つからない場合、crashreporterまたはcrashdumpからの該当するエラーメッセージについて、/var/log/system.logで確認してください。
ご注意：1件のバグにつき1つのクラッシュログを添付してください。毎回全く同じ方法でクラッシュを再現でき、且つ、その都度クラッシュのスレッドが全く同一である場合、クラッシュログは1つだけ必要です。このログによって、アップルのエンジニアに必要な情報が効率良く伝わります。クラッシュが同一でない場合、バグごとにクラッシュログを添付したレポートを作成して1件ずつ提出してください。
***クラッシュ・ログの構造に関する情報は、TN2123ページをご参照ください。
3.3 : Kernel Panic（カーネルパニック）：
カーネルパニックが発生した場合、パニックログが必要です。バックトレースは、nvramに保存され、再起動時にパニック・ログにコピーされます。このファイルは、/Library/Logsにあります。
***パニック・ログの構造に関する情報は、TN2063ページをご参照ください。
3.4 : Hanging/Performance Issues（ハング／パフォーマンスの問題）：
ハング（フリーズ、回転するレインボーカーソル、速度の低下、などを含む）を経験した場合、ハング状態のアプリケーションのサンプルデータが必要です。下記いずれかの方法で、サンプルデータを入手できます：
- Using Terminal（ターミナルを使用）：
run 'sample (Application Name) 15'
アウトプットは、Bug Reporterの'My Originated Problems' セクションでバグレポートに直接添付できます。
- Using Activity Monitor（アクティビティモニタを使用）：
- アクティビティモニタを起動する（/Applications/Utilities/)
- アプリケーションがハングしている状態で、該当アプリケーションをクリックして強調表示させる
- 「表示」 -> 「プロセスのサンプル収集」を選択する
- 「保存」をクリックする
ご注意： "Sample"の使用についての詳細は、「ターミナル」で"man sample"と入力すると読み出されるman pageに表示されます。
- How to SSH into a machine (from another machine on the same network)（同じネットワーク上の他のマシンからSSHを使用）：
マシンがハングしてもSSHでログインできる状態なら、「ターミナル」から以下の手順を実行してください：
- ssh (IPアドレス) -l (ログインアカウント)
- top
- CPUを占有しているプロセスを特定する
- sample (プロセス ID) 5
- cp /tmp/* ~/Desktop/
- マシンを再起動して、SSHでログインしていたユーザでログイン
ご注意：ターミナルコマンドには、等幅フォントを使用してください。
- Shark（ハードウェア解析ツール）：
Sharkプロファイルを入手するには、 Sharkをインストールする必要があります。
Sharkサンプルの取得方法に関する手順については、
こちらをご参照ください。
上記サンプル収集の手段すべてにおいて、サンプルファイルがデスクトップ上に表示されます。
ご注意：システムに"Sampler"という古いアプリケーションがある場合、それは使用しないで下さい。Sharkプロファイルは、さらに役に立つ情報を提供します。
3.5 : Screen shots（スクリーンショット）：
バグレポートを明確にするのに役立つスクリーンショットがある場合は、それを添付して下さい。エラーやダイアログメッセージをスクリーンショットで提供するのに加えて、バグレポートのdescription（説明）欄に実際に表示されたエラーやダイアログメッセージのテキストも必ず入力して下さい。（そうすれば、メッセージの内容が検索可能になります。また、関連する手順の連続したスクリーンショットや動画を添付して頂くと大変役立ちます。（但し、各スクリーンショットごとに関連している手順を記述して下さい。））
- ダイアログが表示される時
- レンダリングや再描画の問題が起こっている時
- アイコンやスクリーンの他の見え方を説明しようとして、それを何と呼ぶか分からない時
以下のいずれかの方法でスクリーンショットを撮ることができます：
| Description（内容） |
Shortcut（ショートカット） |
| スクリーン全体の画像を保存 |
shift-command-3 |
| スクリーンの選択した範囲の画像を保存 |
shift-command-4 |
| プレビューを使ってスクリーンショットを撮る |
- 「グラブ」を起動する（/Applications/Utilities/Grab）
- メニューから「取り込み」->（スクリーンショットの種類）を選択する
|
ページの先頭に戻る
4. 連絡先
現在の連絡先を必ず入力してください。連絡先は、ご提出頂きました問題を分析する際に、報告された方に連絡できるようにするための重要な情報です。
ページの先頭に戻る
5. Apple Product-specific Additional Information Requirements（アップル製品固有の必要追加情報）
以下のアップル製品のいずれかに対するバグレポートに関しては、前述した一般的な情報に加えて、 製品固有の情報が必要です。
Xcode
XcodeやAppleの他のデベロッパツールに関連したバグレポートを提出する時は、以下の追加情報を必ず添付してください：
ページの先頭に戻る
Java
Java関連のバグレポートを提出する時は、以下の追加情報を必ず添付して下さい：
ページの先頭に戻る
Safari
SafariまたはWebKitに関するバグレポートを提出する時は、以下の追加情報を必ず添付してください：
- URLに関連する問題：
URLに関連する問題が起こった場合、そのURLがどのように動作しないのかについて明確に詳述した上で、問題を示すスクリーンショットを提供してください。さらに必ずURLを含めてください。
- JavaScriptの問題：
JavaScriptに関する問題が起こった場合、実際のJavaScript（または、テスト事例）を添付してください。
ページの先頭に戻る
Mail
Mailに関するバグレポートを提出する時は、以下の追加情報を必ず添付してください：
- Mail作成の問題：
Mailでのメッセージ作成に関する問題については、テキストエディットやBlotで再現できるか確認してください。Blotは、/Developer/Examples/WebKit/Blot/ にあります。メッセージを返信する時だけ起こる問題がある場合は、Mailでメッセージに返信を選び、処理する前に「すべてを選択」、「コピー」の後、それをBlot に「ペースト」してください。返信の問題については、しばしばメッセージそのものを提供して頂く必要があります。その場合、メッセージリストの中にあるメッセージを選び、「ファイル」 ->「 別名で保存」、フォーマット形式：「メッセージソース」を選択して保存した生のソースをバグレポートに添付してください。
ご注意：メッセージソースは、表示に関するバグについても必ず必要です。
- Test Account（テストアカウント）：
再現可能な問題のためにテストアカウントを作成できる場合は、それを提供してください。アカウントにログインして問題をテストすることは、問題を特定し、解決に至る一番良い方法です。
- Connection Logs（接続ログ）:
問題を記録した可能な限り最小の接続ログを添付してください。
ご注意：接続ログには、目の前の問題に関係のない多くの紛らわしい情報が含まれている可能性があります。
シナリオ例
同じIMAP サーバ上で別のメールボックスにメッセージを移動しようとすると、Mailがそのメッセージを削除してしまう。
- 初めに、 保留中のものがないことを確認するためMailを調べる
- 問題の起こるメールボックスを選択する
- Mailを終了する
- 以下のコマンドラインを実行する：
/Applications/Mail.app/Contents/MacOS/Mail -LogSocketErrors YES
-LogActivityOnHost your.mail.server -LogActivityOnPort 143 &>
~/Desktop/ConnectionLog.txt
ご注意： **（ステップ5では）ご利用のIMAPサーバの実際のホスト名とポート番号指定する必要があります**
また、"&>"はMac OSの標準シェルであるbashを想定しています。csh/tschの利用者は、">&"を代わりに使う必要があります。LogSocketErrorsはMailを起動します。Mailが起動したら、進行状況パネル（ウインドウ→進行状況）を開きます。そして、何も進行していない状況になったら、メッセージをメールボックスにドラッグします。進行状況が完了したら、Mailを終了します。このことにより、必要な情報だけを含んだ接続ログが取得できます。
- Mailプラグイン、またはシステム "enhancer"（haxie）がインストールされている場合：
Mailプラグインやシステム "enhancer" (haxie) をインストールしているなら、アップルにレポートを送る前に必ずそれらを取り除き、起こった問題を再テストしてください。Mailプラグインは、[~]Library/Mail/Bundles/フォルダのいずれかに入っています。haxieはどんな場所にもインストールされる可能性があります。（iAlertとして知られているものは、プラグインなしでMailに入り込みます。）
***ご注意：現在のところMailは、これらのプラグイン、haxieをサポートしていません。***
- 使用しているコンピュータの設定が標準的でない場合、バグレポートにそのことを明記してください。（例えば、ネットワークディレクトリやポータブルホームディレクトリを利用している、FileVaultをオンにしている、ディスク空き容量が不足している等）
ページの先頭に戻る
iChat
iChatに関連したバグレポートを提出する時は、以下の追加情報を必ず添付してください：
- お使いのiChatバージョン
- 他のIMクライアントとの間で起こる問題：
クライアントのバージョン、OSバーションを明記のうえ、可能ならば、チャット交信のログを添付してください：
例えば、受信側で文字表示がおかしくなる（またはその反対も）バグの場合、データが正しく送られているかを調べるために、tcpflowのダンプ（もしくはWindowsの同様のもの）が役に立ちます。さらに、バグの再現状況の情報も添付してください。（例：問題はそのクライアントで常に起こっていたのか、iChatやOSのアップグレード後に起こり始めたのか）
- (10.4.7以前において)ビデオ会議の開始に失敗する場合は、以下の手順に従って接続ログを提供してください：
- iChatを終了する
- 「ターミナル」を起動する
- 「ターミナル」に以下のコマンドを入力する：
/Applications/iChat.app/Contents/MacOS/iChat -errorLogLevel 7
- 他のユーザとビデオ／オーディオチャットを開始する
- チャットの開始に失敗したターミナルの出力を双方のユーザから集めて、各々のファイルを添付してください
- 10.4.8 以降では、接続ログをiChatダイアログから直接コピーできます。
- また、基本的なポートについてのトラブルシューティングは役に立ちます。UDPトラフィックに関しては、UDPポート16384〜16403 番が双方で開いていることを確認してください。ビデオ／オーディオチャット接続を確立するには、ポート5060番が開かれている必要があります。交信のためには、ポート3456番も開く必要があります。
- APIに関する問題（AppleScript および 弊社 IMフレームワーク）については、実際に試すことのできる小さなサンプルアプリケーションや抜粋したサンプルコードが必要です。
上記すべてに加え、実際に問題が起きたときの操作に関するあらゆる情報を提供してください。
ページの先頭に戻る
Audio
オーディオに関するバグレポートを提出する時は、以下の追加情報を必ず添付してください：
- 再生可能なサンプル事例（プロジェクト）
- ハードウェアドライバ（該当する場合）
- サウンド環境設定パネルのオーディオ／スピーカーの設定内容を提供してください
ご注意：バージョンとビルド情報は、インストールされているソフトウェアの「〜について」ウィンドウや製品に同梱されている印刷物に表示されています。
ページの先頭に戻る
USB/FireWire
USBまたはFirewireに関連する問題についてバグレポートを提出する時は、以下の追加情報を必ず添付してください：
- 省エネルギー設定（スリープ／スリープ解除）の問題：
- お使いのマシンに接続している機材を確認する
- 外部ドライブを使用している場合は、接続している状態でシステムプロファイラの情報を収集する
- お使いのドライブの種類（例えば、USBドライブ、USBフラッシュドライブ、USB zip、FireWire、FireWire800など）を明記する
- ドライブの製造元、モデル、ファームウェアの情報を具体的に記述する
- IntelベースMacとPPCベースMacを両方お持ちの場合、両機種で問題が再現するか試し、両方から関連するデータを弊社に提供してください。
AirMacとiPodに特有の問題については、追加情報が必要です。それぞれ必要な情報の内容については、以下をご参照ください。
ページの先頭に戻る
AirMac
AirMac（クライアントMac、または、ワイアレスベースステーション問題を含む）に関するバグレポートを提出する時は、以下の追加情報を必ず添付してください：
- 使用していれば、暗号化規格（WEP、WPA) について
- ネットワークが見えているかいないか、明記する
- ベースステーション情報の提供：
ワイアレスベースステーションに関係しているバグの可能性がある場合（お使いのベースステーションがアップルのAirMacベースステーションであっても）、製造元、モデル、ファームウェアバージョン、ユニットの設定の概要が必要です。
- Mac OS Xで AirMac設定ファイルを保存するには以下の手順に従ってください。
- /Applications/Utilities を開く
- 「AirMac 管理ユーティリティ」アプリケーションを起動する
- AirMacベースステーションを選び、強調表示させてダブルクッリクする（情報が右の欄に表示されます)
- この設定をファイルとして保存し、バグレポートにアップロードする
- AirMac特有のクライアント情報の提供について：
クライアントのMacに関係している問題の可能性がある場合、お使いのAirMacクライアントソフトウェアバージョン（「 AirMac管理ユーティリティ」のバージョン）と、「ネットワーク環境設定」の「AirMac」タブの設定を記述してください。
- Mac OS X上でAirMacネットワーク設定を確認するには以下の手順です：
- アップルメニュー ->「システム環境設定...」を選択する
ページの先頭に戻る
iPod
iPod製品ラインに関するバグレポートを提出する時は、以下の追加情報を必ず添付してください：
ページの先頭に戻る
iDVD
iDVDの問題についてバグレポートを提出する時は、以下の追加情報を必ず添付してください：
- メディア：
- 使用しているDVD-Rは何ですか？ブランドとスピードを記載してください。
- プロジェクトを焼くのに異なったメディアを使用してみましたか？何が起こりましたか？
- プロジェクト情報：
- いくつのメニューがありますか？
- カスタマイズされたメニューがありますか：はい／いいえ？
- いくつのスライドショーがありますか？
- 全部でいくつの画像がありますか？
- 画像のフォーマットは何で、サイズはいくつですか？
- DVD-ROMのコンテンツがありますか？ある場合は、何ですか？
- ビデオの数、フォーマット、ソース（iMove/FCP/他の種類）について
- 以前から作業している古いプロジェクトですか？あるいは、新しいプロジェクトですか？
- iDVDをご自分で起動させましたか？あるいは、iMovieやiPhotoから起動させましたか？
- プロジェクトで使用されているファイルをどのように作成しましたか？
- 使用したiMovieのバージョンはいくつですか（使用している場合）？
- QuickTimeのバージョンは？
- プロジェクトファイル一式
- ハードウェアドライバ（該当する場合）
ページの先頭に戻る
