Python getopt模块详解与Android OTA构建实例分析

林见深

发布时间：2026-10-13| 2人浏览过

原创

本文详细解析Python中getopt模块的函数原型、参数及返回值，并通过Android OTA构建系统中common.py的ParseOptions函数源码，深入剖析短参数、长参数及自定义处理器的实际应用场景，帮助开发者掌握命令行参数解析的核心机制。

深入解析Python中的getopt模块及其在实战中的应用

函数原型如下所示：

getopt.getopt(args, shortopts, longopts=[])

各参数具体解释如下：

args：该参数接收需要解析的参数列表。通常使用sys.argv[1:]，以排除第一个参数（即脚本名称，无需作为解析对象）。
shortopts：指定简写形式的参数列表。
longopts：指定长形式的参数列表。

关于返回值，getopt返回两个对象：

opts：这是一个列表，包含解析出的(option, value)键值对。
args：这是剩余的命令行参数列表，不包含在格式信息中的部分。

源码深度分析

在Android生成OTA的build系统中，common.py文件内的ParseOptions函数负责解析输入参数。我们将通过该函数的具体实现来剖析getopt的实际用法。

该函数的核心源码如下：

def ParseOptions(argv, docstring, extra_opts="", extra_long_opts=(), extra_option_handler=None):
  try:
    opts, args = getopt.getopt(
      argv, "hvp:s:x" + extra_opts,
      ["help", "verbose", "path=", "signapk_path=", "extra_signapk_args=", "java_path=", "public_key_suffix=", "private_key_suffix=", "device_specific=", "extra="] + list(extra_long_opts))
  except getopt.GetoptError, err:
    Usage(docstring)
    print "**", str(err), "**"
    sys.exit(2)

  path_specified = False

  for o, a in opts:
    if o in ("-h", "--help"):
      Usage(docstring)
      sys.exit()
    elif o in ("-v", "--verbose"):
      OPTIONS.verbose = True
    elif o in ("-p", "--path"):
      OPTIONS.search_path = a
    elif o in ("--signapk_path",):
      OPTIONS.signapk_path = a
    elif o in ("--extra_singapk_args",):
      OPTIONS.extra_signapk_args = shlex.split(a)
    elif o in ("--java_path",):
      OPTIONS.java_path = a
    else:
      if extra_option_handler is None or not extra_option_handler(o, a):
      assert False, "unknown option \"%s\"" % (o,)

  os.environ["PATH"] = (os.path.join(OPTIONS.search_path, "bin") + os.pathsep + os.environ["PATH"])

  return args

其中，extra_option_handler可视为一个函数指针，其作用是对opts中的键值对进行额外的解析处理。

extra_option_handler的具体源码如下：

 def option_handler(o, a):
  if o in ("-b", "--board_config"):
   pass  # deprecated
  elif o in ("-k", "--package_key"):
   OPTIONS.package_key = a
  elif o in ("-i", "--incremental_from"):
   OPTIONS.incremental_source = a
  elif o in ("-w", "--wipe_user_data"):
   OPTIONS.wipe_user_data = True
  elif o in ("-n", "--no_prereq"):
   OPTIONS.omit_prereq = True
  elif o in ("-e", "--extra_script"):
   OPTIONS.extra_script = a
  elif o in ("-a", "--aslr_mode"):
   if a in ("on", "On", "true", "True", "yes", "Yes"):
    OPTIONS.aslr_mode = True
   else:
    OPTIONS.aslr_mode = False
  elif o in ("--worker_threads"):
   OPTIONS.worker_threads = int(a)
  else:
   return False
  return True

通常情况下，生成OTA全量包时的参数argv示例如下：

argv = ['-v', '-p', 'out/host/linux-xxx', '-k', 'build/target/product/security/testkey',
 'out/target/product/xxx/obj/PACKAGING/target_files_intermediates/xxx-target_files.zip', 
'out/target/product/xxx/xxx_20150723.1340-ota.zip']

首先对参数进行分析，其中涉及的短参数包括：

-v,-p,-k,

经过解析后，生成的结果如下所示：

opts = [('-v', ''), ('-p', 'out/host/linux-x86'), 
('-k', 'build/target/product/security/testkey')]
args =['out/target/product/xxx/obj/PACKAGING/target_files_intermediates/xxx-target_files.zip',
 'out/target/product/xxx/xxx_20150723.1340-ota.zip']

感谢阅读，希望本文能对大家有所帮助，感谢各位对本站的支持！