2025 年 3 月 27 日より、AOSP のビルドとコントリビューションには aosp-main ではなく android-latest-release を使用することをおすすめします。詳細については、AOSP の変更をご覧ください。

このページは Cloud Translation API によって翻訳されました。

ArgsOptionParser

public class ArgsOptionParser
extends OptionSetter

java.lang.Object
↳	com.android.tradefed.config.OptionSetter
	↳	com.android.tradefed.config.ArgsOptionParser

解析されたコマンドライン引数から Option フィールドに値を入力します。

渡された String[] 内の文字列は左から右に解析されます。各文字列は、短いオプション（「-v」など）、長いオプション（「--verbose」など）、オプションの引数（「-f out.txt」の「out.txt」など）、オプション以外の位置引数として分類されます。

各オプション引数は、1 つ以上の Option フィールドにマッピングする必要があります。長いオプションは Option 名にマッピングされ、短いオプションは Option の短い名前にマッピングされます。各オプション名とオプションの略称は、同じオブジェクト内の他のすべての Option フィールドに対して一意である必要があります。

1 つのオプション引数は、複数のオブジェクトにわたって同じ名前の複数の Option フィールドにマッピングできます。Option 引数に名前空間を指定すると、そのオブジェクトの完全なクラス名または OptionClass エイリアス値を「:」で区切って、単一オブジェクト内の Option フィールドを一意に参照できます。

 --classname:optionname optionvalue or
 --optionclassalias:optionname optionvalue.

単純な短いオプションは「-」に続いて短いオプション文字が続くものです。オプションに引数が必要（ブール以外のオプションの場合）場合は、別個のパラメータとして記述できますが、必須ではありません。つまり、「-f out.txt」と「-fout.txt」の両方が使用できます。

1 つの「-」の後に複数の短いオプションを指定できます。ただし、最後のオプションを除き、すべて引数を必要としない必要があります。

長いオプションは「--」で始まり、その後に複数の文字が続きます。オプションに引数を必要とする場合は、オプション名の直後に「="」で区切って記述するか、次の引数として記述します。（「--file=out.txt」または「--file out.txt」など）。

ブール値の長いオプション「--name」には、「--no-name」というコンパニオンが自動的に取得されます。オプション「--flag」を指定した場合は、「--flag」、「--no-flag」、「--flag=true」、「--flag=false」のすべてが有効ですが、「--flag true」と「--flag false」は使用できません（「--flag」だけで十分であるため、後続の「true」または「false」は別途解釈されます）。「yes」と「no」は、「true」と「false」の同義語として使用できます。

「-」で始まらず、前のオプションの必須引数でもない各文字列は、後続のすべての文字列と同様に、オプション以外の位置引数です。「--」の後の各文字列は、オプション以外の位置引数です。

オプションに対応するフィールドは、オプションが処理されるたびに更新されます。残りの位置引数は、List<String> として返されます。

簡単な例を次に示します。

 // Non-@Option fields will be ignored.
 class Options {
     @Option(name = "quiet", shortName = 'q')
     boolean quiet = false;

     // Here the user can use --no-color.
     @Option(name = "color")
     boolean color = true;

     @Option(name = "mode", shortName = 'm')
     String mode = "standard; // Supply a default just by setting the field.

     @Option(name = "port", shortName = 'p')
     int portNumber = 8888;

     // There's no need to offer a short name for rarely-used options.
     @Option(name = "timeout" )
     double timeout = 1.0;

     @Option(name = "output-file", shortName = 'o' })
     File output;

     // Multiple options are added to the collection.
     // The collection field itself must be non-null.
     @Option(name = "input-file", shortName = 'i')
     List<File> inputs = new ArrayList<File>();

 }

 Options options = new Options();
 List<String> posArgs = new OptionParser(options).parse("--input-file", "/tmp/file1.txt");
 for (File inputFile : options.inputs) {
     if (!options.quiet) {
        ...
     }
     ...

 }

概要

パブリックコンストラクタ
`ArgsOptionParser( optionSources)` オブジェクトのコレクションの `ArgsOptionParser` を作成します。
`ArgsOptionParser(Object... optionSources)` 1 つ以上のオブジェクトの `ArgsOptionParser` を作成します。

パブリックメソッド
	`getInopOptions()` デフォルト値が変更されていないオプションのセットを返します。
`static String`	`getOptionHelp(boolean importantOnly, Object optionObject)` optionObject 内のすべての `Option` フィールドのヘルプテキストを出力します。
	`parse(String... args)` コマンドライン引数「args」を解析し、コンストラクタに渡された「optionSource」の @Option フィールドを設定します。
	`parse( args)` 引数の `ERROR(/List)` を取る別の `parse(String)` メソッド
	`parseBestEffort( args)` 引数の `ERROR(/List)` を取る別の `parseBestEffort(String)` メソッド
	`parseBestEffort( args, boolean forceContinue)` 引数の `ERROR(/List)` を受け取り、一部の引数が解析されなくても最後まで解析を強制できる、別の `parseBestEffort(String)` メソッド。
	`parseBestEffort(String... args)` `parse(String)` のベストエフォートバージョン。
`void`	`validateMandatoryOptions()` 必須としてマークされているすべてのフィールドが設定されていることを検証します。

パブリックコンストラクタ