記事

バグ ID (識別子) の解釈

テストライブラリが開発者によって提供されたバグ ID をどのように解釈するかを調べます。

概観

テストライブラリは、バグを識別するために 2 つの異なる方法をサポートしています。

バグに関する詳細情報へのリンクする URL。

バグに関連したバグ追跡システムにおける一意の識別子。

注意

このドキュメントで説明されている「バグ」は「問題」と呼ばれることもあります。テストライブラリの Issue の型との混同を避けるため、このドキュメントでは一貫して「バグ」と呼びます。

バグには、関連した URL と一意の識別子の両方がある場合があります。テストライブラリが正しく解釈できるようにするには、少なくともどちらか一方がなければなりません。

URL を持つ Bug インスタンスを作成するには、bug(_:_:) 特性を使用します。コンパイル時に、テストライブラリは与えられた文字列が RFC 3986 に従って URL として解析できるかどうかを検証します。

バグの一意の識別子を持つ Bug インスタンスを作成するには、bug(_:id:_:) 特性を使用します。テストライブラリでは、バグの一意の識別子が特定の書式に一致することを要求しませんが、「FB」で始まる一意の識別子は、Apple Feedback Assistant で追跡されているバグを指すものとして解釈されます。便宜上、bug(_:id:_:) を使用して、バグの識別子として整数を直接渡すこともあなたはできます。

例

特性関数	推論されたバグ追跡システム
.bug(id: 12345)	なし
.bug(id: "12345")	なし
.bug("https://www.example.com?id=12345", id: "12345")	なし
.bug("https://github.com/swiftlang/swift/ pull/12345")	GitHub Issues for the Swift project
.bug("https://bugs.webkit.org/show_bug.cgi? id=12345")	WebKit Bugzilla
.bug(id: "FB12345")	Apple Feedback Assistant

以下も見よ

テストの注釈付け

テストへのタグの追加

タグを使用して、整理、フィルタリング、外観のカスタマイズのための意味情報を提供します。

テストへのコメントの追加

テストに関する有用な情報を提供するためにコメントを追加します。

バグとテストの関連付け

テストによって発見または検証されたバグを関連付けます。

macro Tag()

テスト関数またはテストスイートに適用できるタグを宣言します。

XCode 16.3 日本語化計画

記事

バグ ID (識別子) の解釈

概観

注意

例

以下も見よ

テストの注釈付け