| #!/usr/bin/env python3 |
| # |
| # Copyright 2018 - 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. |
| |
| """AIDEgen |
| |
| This CLI generates project files for using in IntelliJ, such as: |
| - iml |
| - .idea/compiler.xml |
| - .idea/misc.xml |
| - .idea/modules.xml |
| - .idea/vcs.xml |
| - .idea/.name |
| - .idea/copyright/Apache_2.xml |
| - .idea/copyright/progiles_settings.xml |
| |
| - Sample usage: |
| - Change directory to AOSP root first. |
| $ cd /user/home/aosp/ |
| - Generating project files under packages/apps/Settings folder. |
| $ aidegen packages/apps/Settings |
| or |
| $ aidegen Settings |
| or |
| $ cd packages/apps/Settings;aidegen |
| """ |
| |
| from __future__ import absolute_import |
| |
| import argparse |
| import logging |
| import sys |
| |
| from aidegen.lib.android_dev_os import AndroidDevOS |
| from aidegen.lib.common_util import COLORED_INFO |
| from aidegen.lib.common_util import COLORED_PASS |
| from aidegen.lib.common_util import check_modules |
| from aidegen.lib.common_util import time_logged |
| from aidegen.lib.errors import IDENotExistError |
| from aidegen.lib.ide_util import IdeUtil |
| from aidegen.lib.metrics import log_usage |
| from aidegen.lib.module_info_util import generate_module_info_json |
| from aidegen.lib.project_file_gen import generate_eclipse_project_files |
| from aidegen.lib.project_file_gen import generate_ide_project_files |
| from aidegen.lib.project_info import ProjectInfo |
| from aidegen.lib.source_locator import multi_projects_locate_source |
| from atest import module_info |
| |
| AIDEGEN_REPORT_LINK = ('To report the AIDEGen tool problem, please use this ' |
| 'link: https://goto.google.com/aidegen-bug') |
| _NO_LAUNCH_IDE_CMD = """ |
| Can not find IDE in path: {}, you can: |
| - add IDE executable to your $PATH |
| or - specify the exact IDE executable path by "aidegen -p" |
| or - specify "aidegen -n" to generate project file only |
| """ |
| |
| _CONGRATULATION = COLORED_PASS('CONGRATULATION:') |
| _LAUNCH_SUCCESS_MSG = ( |
| 'IDE launched successfully. Please check your IDE window.') |
| _IDE_CACHE_REMINDER_MSG = ( |
| 'To prevent the existed IDE cache from impacting your IDE dependency ' |
| 'analysis, please consider to clear IDE caches if necessary. To do that, in' |
| ' IntelliJ IDEA, go to [File > Invalidate Caches / Restart...].') |
| |
| _SKIP_BUILD_INFO = ('If you are sure the related modules and dependencies have ' |
| 'been already built, please try to use command {} to skip ' |
| 'the building process.') |
| _MAX_TIME = 1 |
| _SKIP_BUILD_INFO_FUTURE = ''.join([ |
| 'AIDEGen build time exceeds {} minute(s).\n'.format(_MAX_TIME), |
| _SKIP_BUILD_INFO.rstrip('.'), ' in the future.' |
| ]) |
| _SKIP_BUILD_CMD = 'aidegen {} -s' |
| _INFO = COLORED_INFO('INFO:') |
| _SKIP_MSG = _SKIP_BUILD_INFO_FUTURE.format( |
| COLORED_INFO('aidegen [ module(s) ] -s')) |
| _TIME_EXCEED_MSG = '\n{} {}\n'.format(_INFO, _SKIP_MSG) |
| _LOG_FORMAT = '%(asctime)s %(filename)s:%(lineno)s:%(levelname)s: %(message)s' |
| _DATE_FORMAT = '%Y-%m-%d %H:%M:%S' |
| |
| |
| def _parse_args(args): |
| """Parse command line arguments. |
| |
| Args: |
| args: A list of arguments. |
| |
| Returns: |
| An argparse.Namespace class instance holding parsed args. |
| """ |
| parser = argparse.ArgumentParser( |
| description=__doc__, |
| formatter_class=argparse.RawDescriptionHelpFormatter, |
| usage=('aidegen [module_name1 module_name2... ' |
| 'project_path1 project_path2...]')) |
| parser.required = False |
| parser.add_argument( |
| 'targets', |
| type=str, |
| nargs='*', |
| default=[''], |
| help=('Android module name or path.' |
| 'e.g. Settings or packages/apps/Settings')) |
| parser.add_argument( |
| '-d', |
| '--depth', |
| type=int, |
| choices=range(10), |
| default=0, |
| help='The depth of module referenced by source.') |
| parser.add_argument( |
| '-v', |
| '--verbose', |
| action='store_true', |
| help='Display DEBUG level logging.') |
| parser.add_argument( |
| '-i', |
| '--ide', |
| default=['j'], |
| help='Launch IDE type, j: IntelliJ, s: Android Studio, e: Eclipse.') |
| parser.add_argument( |
| '-p', |
| '--ide-path', |
| dest='ide_installed_path', |
| help='IDE installed path.') |
| parser.add_argument( |
| '-n', '--no_launch', action='store_true', help='Do not launch IDE.') |
| parser.add_argument( |
| '-r', |
| '--config-reset', |
| dest='config_reset', |
| action='store_true', |
| help='Reset all saved configurations, e.g., preferred IDE version.') |
| parser.add_argument( |
| '-s', |
| '--skip-build', |
| dest='skip_build', |
| action='store_true', |
| help=('Skip building jar or modules that create java files in build ' |
| 'time, e.g. R/AIDL/Logtags.')) |
| return parser.parse_args(args) |
| |
| |
| def _configure_logging(verbose): |
| """Configure the logger. |
| |
| Args: |
| verbose: A boolean. If true, display DEBUG level logs. |
| """ |
| log_format = _LOG_FORMAT |
| datefmt = _DATE_FORMAT |
| level = logging.DEBUG if verbose else logging.INFO |
| logging.basicConfig(level=level, format=log_format, datefmt=datefmt) |
| |
| |
| def _get_ide_util_instance(args): |
| """Get an IdeUtil class instance for launching IDE. |
| |
| Args: |
| args: A list of arguments. |
| |
| Returns: |
| A IdeUtil class instance. |
| """ |
| if args.no_launch: |
| return None |
| ide_util_obj = IdeUtil(args.ide_installed_path, args.ide[0], |
| args.config_reset, |
| AndroidDevOS.MAC == AndroidDevOS.get_os_type()) |
| if not ide_util_obj.is_ide_installed(): |
| ipath = args.ide_installed_path or ide_util_obj.get_default_path() |
| err = _NO_LAUNCH_IDE_CMD.format(ipath) |
| logging.error(err) |
| raise IDENotExistError(err) |
| return ide_util_obj |
| |
| |
| def _check_skip_build(args): |
| """Check if users skip building target, display the warning message. |
| |
| Args: |
| args: A list of arguments. |
| """ |
| if not args.skip_build: |
| msg = _SKIP_BUILD_INFO.format( |
| COLORED_INFO(_SKIP_BUILD_CMD.format(' '.join(args.targets)))) |
| print('\n{} {}\n'.format(_INFO, msg)) |
| |
| |
| def _generate_project_files(ide, projects): |
| """Generate project files by IDE type. |
| |
| Args: |
| ide: IDE type. |
| projects: A list of ProjectInfo instances. |
| """ |
| if ide == 'e': |
| generate_eclipse_project_files(projects) |
| else: |
| generate_ide_project_files(projects) |
| |
| |
| @time_logged(message=_TIME_EXCEED_MSG, maximum=_MAX_TIME) |
| def main_with_message(args): |
| """Main entry with skip build message. |
| |
| Args: |
| args: A list of system arguments. |
| """ |
| aidegen_main(args) |
| |
| |
| @time_logged |
| def main_without_message(args): |
| """Main entry without skip build message. |
| |
| Args: |
| args: A list of system arguments. |
| """ |
| aidegen_main(args) |
| |
| |
| def main(argv): |
| """Main entry. |
| |
| Try to generates project files for using in IDE. |
| |
| Args: |
| argv: A list of system arguments. |
| """ |
| args = _parse_args(argv) |
| if args.skip_build: |
| main_without_message(args) |
| else: |
| main_with_message(args) |
| |
| |
| def aidegen_main(args): |
| """AIDEGen main entry. |
| |
| Try to generates project files for using in IDE. |
| |
| Args: |
| args: A list of system arguments. |
| """ |
| log_usage() |
| _configure_logging(args.verbose) |
| ide_util_obj = _get_ide_util_instance(args) |
| _check_skip_build(args) |
| atest_module_info = module_info.ModuleInfo() |
| check_modules(atest_module_info, args.targets) |
| ProjectInfo.modules_info = generate_module_info_json( |
| atest_module_info, args.targets, args.verbose, args.skip_build) |
| projects = ProjectInfo.generate_projects(atest_module_info, args.targets) |
| multi_projects_locate_source(projects, args.verbose, args.depth, |
| args.skip_build) |
| _generate_project_files(args.ide[0], projects) |
| if ide_util_obj: |
| ide_util_obj.config_ide() |
| # For IntelliJ, use .idea as open target is better than .iml file, |
| # because open the latter is like to open a kind of normal file. |
| ide_util_obj.launch_ide(projects[0].project_absolute_path) |
| print('\n{} {}\n'.format(_CONGRATULATION, _LAUNCH_SUCCESS_MSG)) |
| |
| |
| if __name__ == '__main__': |
| try: |
| main(sys.argv[1:]) |
| finally: |
| print('\n{0} {1}\n\n{0} {2}\n'.format(_INFO, AIDEGEN_REPORT_LINK, |
| _IDE_CACHE_REMINDER_MSG)) |
