显现
命名项目并将其映射到模型。 Y1 和 Y2 需要单独的行,即使它们共享存储库。
对于固件开发人员
Updater CE 是自定义固件的社区目录和安装程序。从基础 ROM 开发您的项目,将其发布为具有正确发布资产的公共存储库,将模型条目添加到 slidia_manifest.xml,测试模型过滤器,并打开拉取请求。一个存储库可以为其支持的每种模型提供服务。
基础 ROM 为定制固件开发人员提供了一个干净的 Android 基础,并启用了无线射频芯片。在 Y1 上,它们支持 Wi-Fi 和 GPS 以及工厂蓝牙和 FM;在 Y2 上,它们支持 Wi-Fi、GPS 和 FM 以及工厂蓝牙。
| 下载 | 设备 | Android | 无线功能 |
|---|---|---|---|
rom.zip | Y1 · Type A | Android 4.2.2 | 将 Wi-Fi 和 GPS 添加到出厂蓝牙和 FM(出厂时 FM 已在 Y1 上运行)。适用于搭载 OS 2.0.0 或更高版本的 Y1 播放器。 |
rom_type_b.zip | Y1 · Type B | Android 4.2.2 | 将 Wi-Fi 和 GPS 添加到出厂蓝牙和 FM(出厂时 FM 已在 Y1 上运行)。适用于操作系统早于 2.0.0 的 Y1 玩家。 |
rom_y2.zip | Y2 | Android 4.4.2 | 为工厂蓝牙添加 Wi-Fi、GPS 和 FM。 Y2 无线电芯片已完全启用,因此 FM 也可在此处使用。 |
文件名是兼容性信号的一部分。保持名称准确,并将 ZIP 文件放入项目的发布资产中,而不仅仅是存储库源树中。
| 资产 | 设备 | 硬件 | 意义 |
|---|---|---|---|
rom.zip | Y1 | Type A | Y1 附带操作系统 2.0.0 或更高版本的设备。 |
rom_type_b.zip | Y1 | Type B | Y1 附带 2.0.0 之前操作系统的设备。 |
rom_y2.zip | Y2 | Y2 | Y2 完整安装包。将其与 Y1 资产分开。 |
更新程序 CE 读取清单作为其目录。每个 <package> 该行告诉它项目名称、存储库、模型和处理程序。当用户选择该项目时,更新程序会检查存储库的已发布版本并查找 rom*.zip 资产。
命名项目并将其映射到模型。 Y1 和 Y2 需要单独的行,即使它们共享存储库。
包含可安装的 ZIP 资产。单个版本可能包含 Y1 Type A、Y1 Type B 和 Y2 包。
使用选定的型号来选择匹配的封装和特定于型号的闪存路径。用户不必猜测文件名。
rom.zip, rom_type_b.zip, 和 rom_y2.zip 当它们属于同一版本时在同一版本上。slidia_manifest.xml 在 Updater CE 分支的根目录中。为该版本支持的每个模型添加一行(Y1 和 Y2 是公共对)。这 repo 值是存储库的 owner/repository; url 是公共项目页面。填写存储库并勾选该版本支持的每个模型。生成器写一个 <package> 每个模型行,仅包含您设置的属性,因此结果与当前匹配 slidia_manifest.xml 格式。下面提供了 Updater CE 读取的每个属性 - 可选属性位于 更多选择.
owner/repository 从网址。
updater.png 或生成的图标。
image_dark 是一个可接受的别名。
icon.
rom.zip 在 Y1 上和 rom_<model>.zip 别处。
rom*.zip.
*-mirror 构建 Portable Flashing Zip 包的存储库。
<package name="Your Firmware" brand="Innioasis" repo="your-account/your-firmware" device="Y1" url="https://github.com/your-account/your-firmware" type="img" handler="Custom Firmware" />
<package name="Your Firmware" brand="Innioasis" repo="your-account/your-firmware" device="Y2" url="https://github.com/your-account/your-firmware" type="img" handler="Custom Firmware" />
发电机获取电流 slidia_manifest.xml 来自此存储库并在之前插入您生成的行 </slidia>.
rom_y2.zip 存在于项目的发布中。对于您的版本支持的所有其他模型也是如此。这些是当前 Updater CE 版本理解的属性。生成器仅写入您填写的内容;该应用程序对于其余部分将回退到合理的默认值。
| 属性 | 需要 | 它的作用 |
|---|---|---|
name | 是的 | 软件名称显示在目录和安装卡上。 |
repo | 是的 | owner/repo。该应用程序读取该存储库的 GitHub 版本。 |
device | 是的 | 目标型号,大写(Y1, Y2, G1, Q3e,……)。每个模型保留一个条目。 |
url | 受到推崇的 | 从目录中打开的项目页面或发行说明。 |
type, handler | 实践中是的 | type="img" 和 handler="Custom Firmware"。其他类型和非固件处理程序将被跳过。 |
brand | 可选 | 目录品牌(Innioasis, Timmkoo)。空使用模型的默认品牌。 |
package_name | 可选 | 发布资产文件名。默认为 rom.zip 在 Y1 上和 rom_<model>.zip 在其他型号上。 |
asset_pattern | 可选 | 对于固件 zip 未命名的版本,不区分大小写的 glob rom*.zip (例如 my-firmware-*.zip). |
type_a_asset, type_b_asset | 可选 | 当文件名不包含常用标记时,识别 Y1 Type A 和 Type B zip 的 Glob。 |
icon | 可选 | 徽标网址。自己发布后使用 updater.png / updater.jpg,并作为每个版本的后备。 |
icon_dark | 可选 | 深色主题标志。 image_dark 是一个可接受的别名。 |
image | 可选 | 二次光艺术作品,尝试后 icon. |
post_install, post_install2 | 可选 | 成功安装后打开的页面。第二个包含多步骤指南。 |
portable_zips | 可选 | 逗号分隔 *-mirror 发布可立即运行的可移植包的存储库。 |
derivative | 可选 | 构建固件的存储库。具有相同衍生根的固件可以保留用户数据。 |
info_repo | 可选 | 应用程序存储库,其版本描述了固件的部署内容。需要 post_install 或 post_install2. |
apk_repo | 可选 | 应用程序存储库,其 APK 应用程序在固件之后安装。 |
min_version | 可选 | 当 Updater CE 早于此版本时隐藏该条目。 |
do_not_keep_data | 可选 | true (还 1 / yes)阻止此固件完全保留数据。 |
slug | 可选 | 链接和保存的安装记录的稳定标识符。空时根据名称和型号生成。 |
description | 可选 | 简短的目录描述。它可以是属性值或元素的文本。 |
slidia_manifest.xml 在存储库中。 使用下面的编辑链接;存储库主机会自动为您创建一个分叉和一个分支。</slidia>, 保持现有条目不变。add-your-firmware),然后针对 Updater CE 存储库打开拉取请求。为发布提供清晰的标签和发布说明。该标签对人们很有用,但 Updater CE 使用 ZIP 资产名称来识别安装包。
共享版本可以包含 rom.zip, rom_type_b.zip, 和 rom_y2.zip。更新程序将它们分开分类,并从模型和硬件过滤器中进行选择。
请勿在 Y2 文件名下包含 Y1 包,或添加未经测试的分散、预加载器或分区数据只是为了使资产出现。
清单不仅仅是一个下载菜单。提取后,Updater CE 使用解析的模型来准备匹配的安装路径。 Y1 和 Y2 具有不同的平台文件、预加载器、分散配置和设备布局。
/> 可以隐藏其后的每个条目。rom.zip, rom_type_b.zip, 和 rom_y2.zip 如适用。python -c "from xml.etree import ElementTree as ET; ET.parse('slidia_manifest.xml'); print('manifest ok')"
对于本地检查,请从存储库根运行该命令。它仅验证 XML 语法;它不能证明版本包含有效的固件或设备可以安全地刷新。
存储库的 skills/ 目录是一个基于源代码的知识库,适用于处理 Y1 和 Y2 硬件、固件、主题和应用程序的代理。每个技能都会为其声明来源命名项目文件,因此代理可以在更改设备之前检查事实。
如何加载技能,事实适用于哪个模型,以及包不应该写入的分区。
MT6572,滚轮作为按键事件,480x360显示,FM/音频路径,存储和Type A/B分区图。
MT6582 板、设备树、GC9503V/ST7701S 面板、PMIC/DAC 导轨、分区和启动映像。
rom.zip 剖析、分散文件、A 级更新合同和发布清单。
Y1 config.json 主题、Rockbox WPS/SBS、Reborn 皮肤和 Y2Player 皮肤格式 v2。
Rockbox Y1/Y2、库存 Android ROM、Y2Linux、Android 应用程序、启动器、发行说明和网站发布。