Unity 获取分发渠道号 (iOS 和 Android)

本插件用于在 Unity 项目中获取 iOS 和 Android 平台的分发渠道号。它是 https://github.com/AlianBlank/GameFrameX 项目的一个子模块。

主要功能

支持 iOS 和 Android 双平台。
提供简单的 API 来获取预设的渠道信息。
iOS 平台在构建时自动在 Info.plist 中添加默认渠道号 (如果未设置)。

如何安装

您可以通过以下三种方式将此插件添加到您的 Unity 项目中：

通过 manifest.json 添加依赖： 在项目 Packages 目录下的 manifest.json 文件的 dependencies 节点中添加如下内容：

{
  "dependencies": {
    "com.gameframex.unity.getchannel": "https://github.com/gameframex/com.gameframex.unity.getchannel.git",
    // ... 其他依赖
  }
}

通过 Unity Package Manager 使用 Git URL： 在 Unity 编辑器中，打开 Window -> Package Manager。点击左上角的 + 号按钮，选择 Add package from git URL...。输入以下 URL 并点击 Add:
```
https://github.com/gameframex/com.gameframex.unity.getchannel.git
```
直接下载或克隆仓库： 将此仓库下载或克隆到您 Unity 项目的 Packages 目录下。Unity 会自动识别并加载该插件。

如何使用

1. 获取渠道号

在您的 C# 脚本中，使用 BlankGetChannel.GetChannelName(string key) 方法来获取渠道号。参数 key 是您在对应平台设置渠道号时使用的键名。

示例代码：

using UnityEngine;

public class MyGameScript : MonoBehaviour
{
    void Start()
    {
        // 假设您在 AndroidManifest.xml 或 Info.plist 中使用的键是 "channelName"
        string channel = BlankGetChannel.GetChannelName("channelName"); 
        Debug.Log("当前渠道号: " + channel);

        // 示例中使用的键是 "appchannel"
        // string exampleChannel = BlankGetChannel.GetChannelName("appchannel");
        // Debug.Log("示例渠道号: " + exampleChannel);
    }
}

2. iOS 平台设置

对于 iOS 平台，插件包含一个构建后处理器 (PostProcessBuildHandler.cs)。如果在构建时项目的 Info.plist 文件中：

没有名为 channel 的键，该脚本会自动添加一个键为 channel，值为 default 的条目。
已经存在 名为 channel 的键，则不会进行任何修改。

您可以在 Xcode 项目的 Info.plist 文件中修改 channel 的值，或者在调用 BlankGetChannel.GetChannelName() 时使用您自定义的键名（确保该键名存在于 Info.plist 中）。

3. Android 平台设置

对于 Android 平台，您需要在 AndroidManifest.xml 文件中定义渠道信息。通常，这是通过在 <application> 标签内添加 <meta-data> 标签来完成的。

例如，如果您想使用键名 channelName 和值为 myCustomChannel：

<application ...>
    <activity ...>
        ...
    </activity>

    <meta-data
        android:name="channelName"
        android:value="myCustomChannel" />

    <!-- 其他 meta-data -->
</application>

然后，您可以在 C# 代码中通过 BlankGetChannel.GetChannelName("channelName") 来获取这个值 (myCustomChannel)。

注意事项

确保您在调用 BlankGetChannel.GetChannelName(string key) 时使用的 key 与您在 Info.plist (iOS) 或 AndroidManifest.xml (Android) 中设置的键名一致。
插件包含 link.xml 文件以防止代码被 Unity 的代码裁剪功能移除。