Android 扩展

要为Android创建一个扩展，你必须分两部分进行。第一部分是添加扩展本身，以及所需的文件，第二部分是创建扩展所需的函数和宏/常量。

函数和常量是用占位符文件来添加的，所以你要添加一个占位符，然后按照上一节的解释定义函数和宏。要添加其余的文件，你需要首先在编辑器的Extra Platforms 部分勾选Android check-box，这将打开扩展的Android属性。

在这里，你可以提供以下细节：

• 类名 : 您的扩展可以有多个类，每个类都有自己的函数和常量，所以您应该给它一个反映其用途的名称。
• Android 权限：在这里，你可以添加你的扩展需要的任何额外权限。这些权限完全取决于扩展的用途，因此你应该检查谷歌提供的安卓平台的文档，或者，如果你使用的是第三方SDK，则是SDK附带的文档。要添加一个新的权限，你需要点击 按钮来添加一个占位符权限，然后在上面做双击 ，将其编辑成所需的内容。你可以使用 按钮删除权限。
• 代码注入：在这里你可以添加任何代码，以便在你的游戏被构建为测试或最终发布时注入（添加）到你的Android应用程序中。在向商店提交任何游戏之前，请确保仔细修改这个（和你的权限），因为不正确的设置会导致你的游戏提交失败。更多信息见下面的章节。

代码注入

任何输入到 "代码注入 "窗口的代码都需要被分成不同的XML组，如上面的截图所示。你在组中使用的XML标签将决定代码被注入到你的应用程序的位置。

你可以使用以下语法来创建代码注入组。

<YYTagName>

// Code to inject

</YYTagName>

以下标签可用于安卓平台。

YYAndroidTopLevelGradle
YYAndroidTopLevelGradleBuildscript
YYAndroidTopLevelGradleBuildscriptRepositories
YYAndroidTopLevelGradleBuildscriptDependencies
YYAndroidTopLevelGradleAllprojects
YYAndroidTopLevelGradleAllprojectsRepositories
YYAndroidTopLevelGradleEnd

YYAndroidGradle
YYAndroidGradleEnd
YYAndroidGradleAndroid
YYAndroidGradleDependencies 
YYAndroidGradleProperties
YYAndroidManifestAttributes
YYAndroidManifestApplicationAttributes
YYAndroidManifestActivityAttributes
YYAndroidManifestActivityInject
YYAndroidManifestApplicationInject
YYAndroidStringValuesInjection
YYAndroidLayout
YYAndroidProguard
YYAndroidLogcat

注入代码的运行时位置取决于标记的类型:

注意 这些路径仅适用于VM；对于YYC，注入的代码将进入{RUNTIME}/yyc目录，其中的路径可能与VM的路径不同。

条件注入

您可以有条件地注入代码，具体取决于扩展选项之一的值。

在代码注入组中，使用 toInject，并在 condition 中使用所需选项：

<YYIosPlist>
 
<toInject condition='${YYEXTOPT_MyExtension_ShouldInject}'>
...
</toInject>
 
</YYIosPlist>

这将仅在选项 YYEXTOPT_MyExtension_ShouldInject 为 true 时在 toInject 标记之间注入代码。该选项应为 Boolean 类型。

您还可以通过在 match 属性中指定特定值来检查该值：

<YYIosPlist>
 
<toInject condition='${YYEXTOPT_MyExtension_ShouldInject}' match='FooBar'>
<string>This content is injected IF condition == match</string>
</toInject>
 
</YYIosPlist>

当选项 YYEXTOPT_MyExtension_ShouldInject 等于 "FooBar" 时，这将仅在 toInject 标记之间注入代码。这允许您匹配任何类型的值，因为当所有扩展选项值都作为字符串提供时，此检查将在编译时完成。

另请参阅：使用扩展选项

使用提示

• 您可以使用 YYAndroidLogcat将自定义日志标签与 Logcat 一起使用。设置您的标签的优先级，例如:
  
  <YYAndroidLogcat>
  myDebugTag:V
  </YYAndroidLogcat>
  
  在您的扩展中，使用日志记录功能记录带有此标签的消息，例如Log.i("myDebugTag", "Hello World");

文件注入

Within the text files added to your extension (see: Adding Files), you can inject code from the Code Injection window by mentioning a tag inside ${ }. For example, say you have a file with the following contents:

<?xml version="1.0" encoding="UTF-8"?>

${YYAndroidMyInjectionTag}

重要 您可以为此创建自己的标签。此类自定义标签必须以 YYAndroid 开头。

此处的 ${YYAndroidMyInjectionTag} 部分将替换为扩展的代码注入窗口中的 <YYAndroidMyInjectionTag> </YYAndroidMyInjectionTag>

自定义文件

您可以在扩展名的文件夹中创建一个名为 "ProjectFiles" 的文件夹 (与其 .yy 文件一起)。放置在此文件夹中的任何文件将在编译时移动到生成的 Android 项目的根目录，并且还可以如上所述地使用注入标记。

源文件

一旦你设置正确，你将需要添加你的扩展包工作所需的文件。要做到这一点，你需要点击底部的按钮，添加SDK或添加源代码，然后浏览你想添加的文件。添加的文件将和你的扩展名一起存储在Android Source目录中。你可以在任何时候通过右键点击 扩展名，选择在资源管理器中打开，来打开这个位置。

关于你为Android创建本地扩展的信息，请参见示例代码。