Android - 如何在构建时为开源项目动态设置包名称？

Question

我正在开发一个开源项目。由于任何人都可以下载源代码并自己构建它，因此我不想在 anywhere 对包名称进行硬编码 - 包括目录结构。

我使用 ant 进行构建。显然我可以修改 build.xml，但我相信这会被 android update 覆盖。无论使用什么都会提交到 Git repo，它不应该太复杂。

目前，直接从 Git 存储库构建代码的过程相当简单。以下是 README 文件的摘录:

$ cd ~/src/isokeys/IsoKeys
$ android list targets # I build against API level 10.
$ android update project --name IsoKeys --target 1 --path ./ # Only needed first time.
$ ant debug && adb -d install -r bin/IsoKeys-debug.apk

对我来说，将包名放在 local.properties 中是有意义的，因为这是 .gitignore 的。由于包名称不会出现在其他任何地方，因此如果不这样做，构建将失败。因此，README 中至少需要多出 1 步，但我希望将其保持在最低限度。

编辑:当然，另一个要求是差异有意义 - 如果您手动重命名包名称，它们就没有意义。

Answer 1

我做了类似的事情(但不是出于这个原因)，需要在构建时更新 list 。我实现这一点的方法是制作第二个 AndroidManifest 并将其放在名为 config 的目录下。所以在 config/AndroidManifest 你可以有这样的东西:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
      package="@CONFIG.APP_PACKAGE_NAME@"
      android:versionCode="@CONFIG.APP_VERSION_CODE@"
      android:versionName="@CONFIG.APP_VERSION@">


<!-- EVERYTHING ELSE GOES HERE -->


</manifest>

然后您可以使用常规的基本框架 build.xml ant 脚本，只需进行一些修改(无需从 android 构建系统复制整个脚本，因为它们添加了一些钩子(Hook)供您使用，而无需重新发明轮子)。默认情况下，构建脚本应该读取 local.properties，但如果不添加(或取消注释)这样的行:

<property file="local.properties" />

在您的构建脚本中，您应该会看到一个名为“-pre-build”的任务，将其更改为:

<target name="-pre-build">
     <copy file="config/AndroidManifest.xml" todir="." overwrite="true" encoding="utf-8">
       <filterset>
          <filter token="CONFIG.APP_PACKAGE_NAME" value="${app.packagename}" />
          <filter token="CONFIG.APP_VERSION" value="${app.version}" />
          <filter token="CONFIG.APP_VERSION_CODE" value="${app.versioncode}" />
       </filterset>
     </copy>           
</target>

然后你的 local.properties 文件你会像这样放置包名、版本名/代码:

app.version=1.0
app.versioncode=1
app.packagename=com.mypackage.name

现在您只需确保在 list 中完全限定所有 Activity/服务/广播监听器等。这意味着您始终指定源代码的完整包。如果您希望您自己的源代码的包是动态的，您可以替换每个类的每个前缀。但这似乎有点愚蠢。将您的代码打包到您自己的包名下很容易，它们只需在项目中包含源代码或 jar 即可在任何项目中使用它。

-- 更新--哦，你可以做的另一件事是通知用户他们必须定义一个包名称是在你的构建 xml 中使用失败标记，如下所示:

<fail message="app.packagename is missing. This must be defined in your local.properties file" unless="app.packagename" />

将其放在读取 local.properties 文件的行之后