/* * Copyright (C) 2015, The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "options.h" #include "logging.h" #include "os.h" #include #include #include #include #include #include #include #include #include "aidl_language.h" using android::base::Split; using android::base::Trim; using std::endl; using std::string; #ifndef PLATFORM_SDK_VERSION #define PLATFORM_SDK_VERSION "" #endif namespace android { namespace aidl { string Options::GetUsage() const { std::ostringstream sstr; sstr << "AIDL Compiler: built for platform SDK version " << PLATFORM_SDK_VERSION << endl; sstr << "usage:" << endl << myname_ << " --lang={java|cpp|ndk|rust} [OPTION]... INPUT..." << endl << " Generate Java, C++ or Rust files for AIDL file(s)." << endl << endl << myname_ << " --preprocess OUTPUT INPUT..." << endl << " Create an AIDL file having declarations of AIDL file(s)." << endl << endl #ifndef _WIN32 << myname_ << " --dumpapi --out=DIR INPUT..." << endl << " Dump API signature of AIDL file(s) to DIR." << endl << endl << myname_ << " --checkapi[={compatible|equal}] OLD_DIR NEW_DIR" << endl << " Check whether NEW_DIR API dump is {compatible|equal} extension " << endl << " of the API dump OLD_DIR. Default: compatible" << endl #endif << endl; // Legacy option formats if (language_ == Options::Language::JAVA) { sstr << myname_ << " [OPTION]... INPUT [OUTPUT]" << endl << " Generate a Java file for an AIDL file." << endl << endl; } else if (language_ == Options::Language::CPP) { sstr << myname_ << " [OPTION]... INPUT HEADER_DIR OUTPUT" << endl << " Generate C++ headers and source for an AIDL file." << endl << endl; } else if (language_ == Options::Language::RUST) { sstr << myname_ << " [OPTION]... INPUT [OUTPUT]" << endl << " Generate Rust file for an AIDL file." << endl << endl; } sstr << "OPTION:" << endl << " -I DIR, --include=DIR" << endl << " Use DIR as a search path for import statements." << endl << " -m FILE, --import=FILE" << endl << " Import FILE directly without searching in the search paths." << endl << " -p FILE, --preprocessed=FILE" << endl << " Include FILE which is created by --preprocess." << endl << " -d FILE, --dep=FILE" << endl << " Generate dependency file as FILE. Don't use this when" << endl << " there are multiple input files. Use -a then." << endl << " -o DIR, --out=DIR" << endl << " Use DIR as the base output directory for generated files." << endl << " -h DIR, --header_out=DIR" << endl << " Generate C++ headers under DIR." << endl << " -a" << endl << " Generate dependency file next to the output file with the" << endl << " name based on the input file." << endl << " -b" << endl << " Trigger fail when trying to compile a parcelable." << endl << " --ninja" << endl << " Generate dependency file in a format ninja understands." << endl << " --structured" << endl << " Whether this interface is defined exclusively in AIDL." << endl << " It is therefore a candidate for stabilization." << endl << " --stability=" << endl << " The stability requirement of this interface." << endl << " -t, --trace" << endl << " Include tracing code for systrace. Note that if either" << endl << " the client or service code is not auto-generated by this" << endl << " tool, that part will not be traced." << endl << " --transaction_names" << endl << " Generate transaction names." << endl << " --apimapping" << endl << " Generates a mapping of declared aidl method signatures to" << endl << " the original line number. e.g.: " << endl << " If line 39 of foo/bar/IFoo.aidl contains:" << " void doFoo(int bar, String baz);" << endl << " Then the result would be:" << endl << " foo.bar.Baz|doFoo|int,String,|void" << endl << " foo/bar/IFoo.aidl:39" << endl << " -v VER, --version=VER" << endl << " Set the version of the interface and parcelable to VER." << endl << " VER must be an interger greater than 0." << endl << " --hash=HASH" << endl << " Set the interface hash to HASH." << endl << " --log" << endl << " Information about the transaction, e.g., method name, argument" << endl << " values, execution time, etc., is provided via callback." << endl << " -Werror" << endl << " Turn warnings into errors." << endl << " -Wno-error=" << endl << " Turn the specified warning into a warning even if -Werror is specified." << endl << " -W" << endl << " Enable the specified warning." << endl << " -Wno-" << endl << " Disable the specified warning." << endl << " -w" << endl << " Disable all diagnostics. -w wins -Weverything" << endl << " -Weverything" << endl << " Enable all diagnostics." << endl << " --help" << endl << " Show this help." << endl << endl << "INPUT:" << endl << " An AIDL file." << endl << endl << "OUTPUT:" << endl << " Path to the generated Java or C++ source file. This is ignored when" << endl << " -o or --out is specified or the number of the input files are" << endl << " more than one." << endl << " For Java, if omitted, Java source file is generated at the same" << endl << " place as the input AIDL file," << endl << endl << "HEADER_DIR:" << endl << " Path to where C++ headers are generated." << endl; return sstr.str(); } string to_string(Options::Language language) { switch (language) { case Options::Language::CPP: return "cpp"; case Options::Language::JAVA: return "java"; case Options::Language::NDK: return "ndk"; case Options::Language::RUST: return "rust"; case Options::Language::UNSPECIFIED: return "unspecified"; default: AIDL_FATAL(AIDL_LOCATION_HERE) << "Unexpected Options::Language enumerator: " << static_cast(language); } } bool Options::StabilityFromString(const std::string& stability, Stability* out_stability) { if (stability == "vintf") { *out_stability = Stability::VINTF; return true; } return false; } Options Options::From(const string& cmdline) { vector args = Split(cmdline, " "); return From(args); } Options Options::From(const vector& args) { Options::Language lang = Options::Language::JAVA; int argc = args.size(); if (argc >= 1 && args.at(0) == "aidl-cpp") { lang = Options::Language::CPP; } const char* argv[argc + 1]; for (int i = 0; i < argc; i++) { argv[i] = args.at(i).c_str(); } argv[argc] = nullptr; return Options(argc, argv, lang); } Options::Options(int argc, const char* const raw_argv[], Options::Language default_lang) : myname_(raw_argv[0]), language_(default_lang) { std::vector argv = warning_options_.Parse(argc, raw_argv, error_message_); if (!Ok()) return; argc = argv.size(); bool lang_option_found = false; optind = 0; while (true) { static struct option long_options[] = { {"lang", required_argument, 0, 'l'}, {"preprocess", no_argument, 0, 's'}, #ifndef _WIN32 {"dumpapi", no_argument, 0, 'u'}, {"no_license", no_argument, 0, 'x'}, {"checkapi", optional_argument, 0, 'A'}, #endif {"apimapping", required_argument, 0, 'i'}, {"include", required_argument, 0, 'I'}, {"import", required_argument, 0, 'm'}, {"preprocessed", required_argument, 0, 'p'}, {"dep", required_argument, 0, 'd'}, {"out", required_argument, 0, 'o'}, {"header_out", required_argument, 0, 'h'}, {"ninja", no_argument, 0, 'n'}, {"stability", required_argument, 0, 'Y'}, {"structured", no_argument, 0, 'S'}, {"trace", no_argument, 0, 't'}, {"transaction_names", no_argument, 0, 'c'}, {"version", required_argument, 0, 'v'}, {"log", no_argument, 0, 'L'}, {"hash", required_argument, 0, 'H'}, {"help", no_argument, 0, 'e'}, {0, 0, 0, 0}, }; const int c = getopt_long(argc, const_cast(argv.data()), "I:m:p:d:o:h:abtv:", long_options, nullptr); if (c == -1) { // no more options break; } switch (c) { case 'l': if (language_ == Options::Language::CPP) { // aidl-cpp can't set language. aidl-cpp exists only for backwards // compatibility. error_message_ << "aidl-cpp does not support --lang." << endl; return; } else { lang_option_found = true; string lang = Trim(optarg); if (lang == "java") { language_ = Options::Language::JAVA; task_ = Options::Task::COMPILE; } else if (lang == "cpp") { language_ = Options::Language::CPP; task_ = Options::Task::COMPILE; } else if (lang == "ndk") { language_ = Options::Language::NDK; task_ = Options::Task::COMPILE; } else if (lang == "rust") { language_ = Options::Language::RUST; task_ = Options::Task::COMPILE; } else { error_message_ << "Unsupported language: '" << lang << "'" << endl; return; } } break; case 's': if (task_ != Options::Task::UNSPECIFIED) { task_ = Options::Task::PREPROCESS; } break; #ifndef _WIN32 case 'u': if (task_ != Options::Task::UNSPECIFIED) { task_ = Options::Task::DUMP_API; } break; case 'x': dump_no_license_ = true; break; case 'A': if (task_ != Options::Task::UNSPECIFIED) { task_ = Options::Task::CHECK_API; // to ensure that all parcelables in the api dumpes are structured structured_ = true; if (optarg) { if (strcmp(optarg, "compatible") == 0) check_api_level_ = CheckApiLevel::COMPATIBLE; else if (strcmp(optarg, "equal") == 0) check_api_level_ = CheckApiLevel::EQUAL; else { error_message_ << "Unsupported --checkapi level: '" << optarg << "'" << endl; return; } } } break; #endif case 'I': { import_dirs_.emplace(Trim(optarg)); break; } case 'm': { import_files_.emplace(Trim(optarg)); break; } case 'p': preprocessed_files_.emplace_back(Trim(optarg)); break; case 'd': dependency_file_ = Trim(optarg); break; case 'o': output_dir_ = Trim(optarg); if (output_dir_.back() != OS_PATH_SEPARATOR) { output_dir_.push_back(OS_PATH_SEPARATOR); } break; case 'h': output_header_dir_ = Trim(optarg); if (output_header_dir_.back() != OS_PATH_SEPARATOR) { output_header_dir_.push_back(OS_PATH_SEPARATOR); } break; case 'n': dependency_file_ninja_ = true; break; case 'S': structured_ = true; break; case 'Y': { const string stability_str = Trim(optarg); if (!StabilityFromString(stability_str, &stability_)) { error_message_ << "Unrecognized stability level: '" << stability_str << "'. Must be vintf." << endl; return; } break; } case 't': gen_traces_ = true; break; case 'a': auto_dep_file_ = true; break; case 'b': fail_on_parcelable_ = true; break; case 'c': gen_transaction_names_ = true; break; case 'v': { const string ver_str = Trim(optarg); int ver = atoi(ver_str.c_str()); if (ver > 0) { version_ = ver; } else { error_message_ << "Invalid version number: '" << ver_str << "'. " << "Version must be a positive natural number." << endl; return; } break; } case 'H': hash_ = Trim(optarg); break; case 'L': gen_log_ = true; break; case 'e': std::cerr << GetUsage(); exit(0); case 'i': output_file_ = Trim(optarg); task_ = Task::DUMP_MAPPINGS; break; default: std::cerr << GetUsage(); exit(1); } } // while // Positional arguments if (!lang_option_found && task_ == Options::Task::COMPILE) { // the legacy arguments format if (argc - optind <= 0) { error_message_ << "No input file" << endl; return; } if (language_ == Options::Language::JAVA || language_ == Options::Language::RUST) { input_files_.emplace_back(argv[optind++]); if (argc - optind >= 1) { output_file_ = argv[optind++]; } else if (output_dir_.empty()) { // when output is omitted and -o option isn't set, the output is by // default set to the input file path with .aidl is replaced to .java. // If -o option is set, the output path is calculated by // GetOutputFilePath which returns "// // .java" output_file_ = input_files_.front(); if (android::base::EndsWith(output_file_, ".aidl")) { output_file_ = output_file_.substr(0, output_file_.length() - strlen(".aidl")); } output_file_ += (language_ == Options::Language::JAVA) ? ".java" : ".rs"; } } else if (IsCppOutput()) { input_files_.emplace_back(argv[optind++]); if (argc - optind < 2) { error_message_ << "No HEADER_DIR or OUTPUT." << endl; return; } output_header_dir_ = argv[optind++]; if (output_header_dir_.back() != OS_PATH_SEPARATOR) { output_header_dir_.push_back(OS_PATH_SEPARATOR); } output_file_ = argv[optind++]; } if (argc - optind > 0) { error_message_ << "Too many arguments: "; for (int i = optind; i < argc; i++) { error_message_ << " " << argv[i]; } error_message_ << endl; } } else { // the new arguments format if (task_ == Options::Task::COMPILE || task_ == Options::Task::DUMP_API) { if (argc - optind < 1) { error_message_ << "No input file." << endl; return; } } else { if (argc - optind < 2) { error_message_ << "Insufficient arguments. At least 2 required, but " << "got " << (argc - optind) << "." << endl; return; } if (task_ != Options::Task::CHECK_API && task_ != Options::Task::DUMP_MAPPINGS) { output_file_ = argv[optind++]; } } while (optind < argc) { input_files_.emplace_back(argv[optind++]); } } // filter out invalid combinations if (lang_option_found) { if (IsCppOutput() && task_ == Options::Task::COMPILE) { if (output_dir_.empty()) { error_message_ << "Output directory is not set. Set with --out." << endl; return; } if (output_header_dir_.empty()) { error_message_ << "Header output directory is not set. Set with " << "--header_out." << endl; return; } } if (language_ == Options::Language::JAVA && task_ == Options::Task::COMPILE) { if (output_dir_.empty()) { error_message_ << "Output directory is not set. Set with --out." << endl; return; } if (!output_header_dir_.empty()) { error_message_ << "Header output directory is set, which does not make " << "sense for Java." << endl; return; } } if (language_ == Options::Language::RUST && task_ == Options::Task::COMPILE) { if (output_dir_.empty()) { error_message_ << "Output directory is not set. Set with --out." << endl; return; } if (!output_header_dir_.empty()) { error_message_ << "Header output directory is set, which does not make " << "sense for Rust." << endl; return; } } } if (task_ == Options::Task::COMPILE) { for (const string& input : input_files_) { if (!android::base::EndsWith(input, ".aidl")) { error_message_ << "Expected .aidl file for input but got '" << input << "'" << endl; return; } } if (!output_file_.empty() && input_files_.size() > 1) { error_message_ << "Multiple AIDL files can't be compiled to a single " << "output file '" << output_file_ << "'. " << "Use --out=DIR instead for output files." << endl; return; } if (!dependency_file_.empty() && input_files_.size() > 1) { error_message_ << "-d or --dep doesn't work when compiling multiple AIDL " << "files. Use '-a' to generate dependency file next to " << "the output file with the name based on the input " << "file." << endl; return; } if (gen_log_ && (language_ != Options::Language::CPP && language_ != Options::Language::NDK)) { error_message_ << "--log is currently supported for either --lang=cpp or --lang=ndk" << endl; return; } } if (task_ == Options::Task::PREPROCESS) { if (version_ > 0) { error_message_ << "--version should not be used with '--preprocess'." << endl; return; } } if (task_ == Options::Task::CHECK_API) { if (input_files_.size() != 2) { error_message_ << "--checkapi requires two inputs for comparing, " << "but got " << input_files_.size() << "." << endl; return; } } if (task_ == Options::Task::DUMP_API) { if (output_dir_.empty()) { error_message_ << "--dumpapi requires output directory. Use --out." << endl; return; } } AIDL_FATAL_IF(!output_dir_.empty() && output_dir_.back() != OS_PATH_SEPARATOR, output_dir_); AIDL_FATAL_IF(!output_header_dir_.empty() && output_header_dir_.back() != OS_PATH_SEPARATOR, output_header_dir_); } std::vector WarningOptions::Parse(int argc, const char* const raw_argv[], ErrorMessage& error_message) { std::vector remains; for (int i = 0; i < argc; i++) { auto arg = raw_argv[i]; if (strcmp(arg, "-Weverything") == 0) { enable_all_ = true; } else if (strcmp(arg, "-Werror") == 0) { as_errors_ = true; } else if (strcmp(arg, "-w") == 0) { disable_all_ = true; } else if (base::StartsWith(arg, "-Wno-error=")) { no_errors_.insert(arg + strlen("-Wno-error=")); } else if (base::StartsWith(arg, "-Wno-")) { disabled_.insert(arg + strlen("-Wno-")); } else if (base::StartsWith(arg, "-W")) { enabled_.insert(arg + strlen("-W")); } else { remains.push_back(arg); } } for (const auto& names : {no_errors_, disabled_, enabled_}) { for (const auto& name : names) { if (kAllDiagnostics.count(name) == 0) { error_message << "unknown warning: " << name << "\n"; return {}; } } } return remains; } DiagnosticMapping WarningOptions::GetDiagnosticMapping() const { DiagnosticMapping mapping; for (const auto& [_, d] : kAllDiagnostics) { bool enabled = d.default_enabled; if (enable_all_ || enabled_.find(d.name) != enabled_.end()) { enabled = true; } if (disable_all_ || disabled_.find(d.name) != disabled_.end()) { enabled = false; } DiagnosticSeverity severity = DiagnosticSeverity::DISABLED; if (enabled) { severity = DiagnosticSeverity::WARNING; if (as_errors_ && no_errors_.find(d.name) == no_errors_.end()) { severity = DiagnosticSeverity::ERROR; } } mapping.Severity(d.id, severity); } return mapping; } } // namespace aidl } // namespace android