iOS / tvOS 扩展

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

函数和常量是通过占位符文件来添加的，所以你要添加一个占位符，然后按照这里的解释来定义函数和宏。要添加其余的文件，你需要首先在编辑器的附加功能部分勾选iOS 和/或tvOS 复选框，以打开相关的扩展属性窗口（下图是iOS的属性窗口，但tvOS的窗口是完全一样的）。

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

• 编译器标志/链接器标志: 一些框架和第三方SDK需要添加额外的链接器标志和编译器标志才能工作，可以在这里指定（详情请参见相关SDK或框架的随附文档）。
• 类名：你的扩展可以有多个类，每个类都有自己的函数和常量，所以你应该给它起一个能反映其用途的名字。
• App Delegate Class Name: The name of your custom app delegate class. Setting this allows the extension to override/extend core app functionality. To use this feature you need to do the following:
  1. Ensure that the delegate source files have the same name as the delegate class (e.g. @interface MyCustomAppDelegate should be defined in " MyCustomAppDelegate.h")
  2. Add the ${YYExtAppDelegateIncludes} environment variable at the top of your app delegate header file. This will be replaced at compile-time with the relevant include files for the parent delegate class.
  3. Use the ${YYExtAppDelegateBaseClass} environment variable as the base class for your custom app delegate. This will be replaced at compile-time with the correct base delegate class.
     
     To ensure your extension works with any other extensions that use custom app delegates, you should call any base class methods from overridden methods in your child class. Before calling the superclass method, you need to make sure it is implemented in the class hierarchy to avoid errors, for e.g.:

  - (BOOL)application:(UIApplication *)application willFinishLaunchingWithOptions:(NSDictionary *)launchOptions
  {
      // Check if any superclasses implement this method and call it
      if([[self superclass] instancesRespondToSelector:@selector(application:willFinishLaunchingWithOptions:)])
        return [super application:application willFinishLaunchingWithOptions:launchOptions];
      else
          return TRUE;
  }

• 系统框架：在这里，你可以添加任何iOS系统 框架到你的扩展中。通过点击 按钮，可以添加一个占位符框架，然后你可以通过双击 对其进行编辑。你可以在这里找到更多关于可用的系统框架。要删除一个系统框架，只需选择它，然后点击 按钮。
  
  你可以启用某个框架的复选框，将其标记为"弱参考"。这将它添加到Xcode的"Build Phases -> Link Binary with Libraries"部分，作为一个"Optional"框架，而不是一个"Required"框架（这是默认行为）。
• 第三方框架+捆绑包：这一部分是用来添加第三方和SDK捆绑包的。与系统框架一样，你点击 按钮来添加它们，然后双击来编辑，选择它们然后点击 将删除它们（关于框架名称的信息，请参见你选择的SDK附带的文档）
  
  在这里你可以选择不嵌入框架，嵌入&签署它，或者嵌入它而不签署：
  这反映了Xcode中"框架、库和嵌入内容"下添加框架的相同选项
• 输入Mac上的框架路径：如果你想添加一个框架的扩展，其文件存在于用于构建你的项目的Mac上，你可以在这个字段中输入该框架的路径（在构建机器上），然后点击 按钮来添加它。
  
  该路径需要指向一个.framework文件，该文件将被压缩为.zip，并放置在你的扩展目录下的iOSSourceFromMac文件夹中；你可以在任何时候通过右击 扩展，选择在资源管理器中打开，轻松打开该文件。
• 添加来源：你可以用它来添加扩展工作所需的源文件。添加的文件将被存储在你的扩展目录下的iOSSource 文件夹中。
• 代码注入：在这里你可以添加任何代码，以便在你的游戏被构建为测试或最终发布时被注入（添加）到你的iOS应用程序中。在向商店提交任何游戏之前，请确保仔细修改这个（和你的权限），因为不正确的设置将导致你的游戏提交失败。

代码注入

代码注入可用于iOS/tvOS扩展，方法与Android扩展页面上的描述相同：见代码注入。

以下标签可用于iOS和tvOS平台。

YYIosPlist
YYIosEntitlements
YYIosCocoaPods
YYIosCocoaPodsDependencies
YYIosBuildRules
YYIosBuildSettingsInjection
YYIosScriptPhase
YYIosCFBundleURLSchemesArray
YYIosLSApplicationQueriesSchemesArray
YYIosPrivacyManifest

YYTvosPlist
YYTvosEntitlements
YYTvosCocoaPods
YYTvosCocoaPodsDependencies
YYTvosBuildRules
YYTvosBuildSettingsInjection
YYTvosScriptPhase
YYTvosCFBundleURLSchemesArray
YYTvosLSApplicationQueriesSchemesArray
YYTvosPrivacyManifest

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

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

也可以有条件地注入标记。请参阅：条件注入

文件注入

在添加到扩展名的文本文件中(请参阅：添加文件)，您可以通过在 ${ } 中提及标记来从"代码注入"窗口注入代码。例如，假设您有一个包含以下内容的文件：

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

    ${YYIosMyInjectionTag}

</dict>

重要 您可以为此创建自己的标记。此类自定义标记必须以 YYIos 或 YYTvos 开头(取决于平台)。

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

自定义文件

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

其他资料

如果你的扩展添加了任何系统框架或第三方框架，这些框架现在将被列在扩展属性窗口中，每个框架旁边都有一个复选框。如果你选中该复选框，你就启用了弱连接，如果你需要用你自己的值 "覆盖 "内含库中的任何符号，这很有用，但应该注意，这样做会减慢连接速度。

关于你为iOS创建原生扩展的信息，请参见 示例代码，关于在扩展中使用CocoaPods的信息，请参见以下指南。

• iOS 和 tvOS: 使用 Cocoa Pods