1 /* 2 * Copyright (C) 2018 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 #ifndef AAPT2_COMPILE_H 18 #define AAPT2_COMPILE_H 19 20 #include <androidfw/StringPiece.h> 21 22 #include <optional> 23 24 #include "Command.h" 25 #include "ResourceTable.h" 26 #include "androidfw/IDiagnostics.h" 27 #include "format/Archive.h" 28 #include "process/IResourceTableConsumer.h" 29 30 namespace aapt { 31 32 struct CompileOptions { 33 std::string output_path; 34 std::optional<std::string> source_path; 35 std::optional<std::string> res_dir; 36 std::optional<std::string> res_zip; 37 std::optional<std::string> generate_text_symbols_path; 38 std::optional<Visibility::Level> visibility; 39 bool pseudolocalize = false; 40 bool no_png_crunch = false; 41 bool legacy_mode = false; 42 // See comments on aapt::ResourceParserOptions. 43 bool preserve_visibility_of_styleables = false; 44 bool verbose = false; 45 }; 46 47 /** Parses flags and compiles resources to be used in linking. */ 48 class CompileCommand : public Command { 49 public: CompileCommand(android::IDiagnostics * diagnostic)50 explicit CompileCommand(android::IDiagnostics* diagnostic) 51 : Command("compile", "c"), diagnostic_(diagnostic) { 52 SetDescription("Compiles resources to be linked into an apk."); 53 AddRequiredFlag("-o", "Output path", &options_.output_path, Command::kPath); 54 AddOptionalFlag("--dir", "Directory to scan for resources", &options_.res_dir, Command::kPath); 55 AddOptionalFlag("--zip", "Zip file containing the res directory to scan for resources", 56 &options_.res_zip, Command::kPath); 57 AddOptionalFlag("--output-text-symbols", 58 "Generates a text file containing the resource symbols in the\n" 59 "specified file", &options_.generate_text_symbols_path, Command::kPath); 60 AddOptionalSwitch("--pseudo-localize", "Generate resources for pseudo-locales " 61 "(en-XA and ar-XB)", &options_.pseudolocalize); 62 AddOptionalSwitch("--no-crunch", "Disables PNG processing", &options_.no_png_crunch); 63 AddOptionalSwitch("--legacy", "Treat errors that used to be valid in AAPT as warnings", 64 &options_.legacy_mode); 65 AddOptionalSwitch("--preserve-visibility-of-styleables", 66 "If specified, apply the same visibility rules for\n" 67 "styleables as are used for all other resources.\n" 68 "Otherwise, all stylesables will be made public.", 69 &options_.preserve_visibility_of_styleables); 70 AddOptionalFlag("--visibility", 71 "Sets the visibility of the compiled resources to the specified\n" 72 "level. Accepted levels: public, private, default", &visibility_); 73 AddOptionalSwitch("-v", "Enables verbose logging", &options_.verbose); 74 AddOptionalFlag("--trace-folder", "Generate systrace json trace fragment to specified folder.", 75 &trace_folder_); 76 AddOptionalFlag("--source-path", 77 "Sets the compiled resource file source file path to the given string.", 78 &options_.source_path); 79 } 80 81 int Action(const std::vector<std::string>& args) override; 82 83 private: 84 android::IDiagnostics* diagnostic_; 85 CompileOptions options_; 86 std::optional<std::string> visibility_; 87 std::optional<std::string> trace_folder_; 88 }; 89 90 int Compile(IAaptContext* context, io::IFileCollection* inputs, IArchiveWriter* output_writer, 91 CompileOptions& options); 92 93 }// namespace aapt 94 95 #endif //AAPT2_COMPILE_H 96