ungoogled-chromium-binaries

用于 ungoogled-chromium 贡献者提交的二进制文件（贡献者二进制文件）的网站。

重要提示：这些二进制文件由任何愿意构建并提交它们的人提供。由于这些二进制文件不一定可重现，无法保证其真实性。

网站链接在此

新二进制文件的 Atom 源在此。

本网站使用 master 分支上的 GitHub Pages。

如有问题、建议或疑问，请使用 Issue 跟踪器。

开发者信息

在创建新页面或添加新版本时，请使用现有版本作为模板进行参考。如果您有任何问题或建议，请创建一个 Issue。

发布新二进制文件

确保您的二进制文件的源代码已发布到平台仓库。否则，您的 PR 将不会被合并。

先决条件：

• 所有 utilities/ 下的脚本需要 Python 3

步骤

发布新二进制文件的步骤。下一节提供了这些步骤的示例。

1. 确保你的二进制文件已将源代码发布到平台仓库。
2. Fork 主二进制文件仓库（ungoogled-software/ungoogled-chromium-binaries)
   • 如果之前已经执行过此操作，如有必要，请从此仓库拉取新的更改。
3. 在 fork 中创建一个新的 Release（例如使用 GitHub 的 Release 功能），并将二进制文件上传到该 Release。所使用的标签名称对于每个 Release 必须是唯一的；它通常与 ungoogled-chromium 的版本匹配。
4. 将二进制文件上传到新的 Release
5. 使用 utilities/submit_github_binary.py 生成包含指向 GitHub Release 的正确 URL 的 INI 文件。它需要本地存储的二进制文件副本的路径以计算哈希值。使用 -h 或 --help 参数以获取更多详细信息。
   • 如果 config/platforms 中不存在针对二进制文件目标平台和版本的目录结构，请以与现有平台相同的方式创建必要的目录，并在其中包含相关的 display_name 文件。
6. 推送你在仓库中的更改；这些更改应仅涉及 config/ 中的文件。针对主仓库发起一个 pull request。
   • 如果属于 Binaries Team 的成员，可以绕过此步骤。

Notes:

• submit_github_binary.py 目前仅限于生成包含指向 GitHub releases 中二进制文件 URL 的 INI 文件。如果二进制文件上传到其他位置，则必须通过其他方式创建 INI 文件。
• 如有必要，可以在步骤 5 之前对网站配置进行额外的更改。

Example

命令行步骤示例（包含注释，以井号 # 符号表示）。请将步骤中的 YOURNAME 替换为您的 GitHub 用户名。

首次设置：

# In GitHub, fork ungoogled-software/ungoogled-chromium-binaries to YOURNAME/ungoogled-chromium-binaries
git clone https://github.com/YOURNAME/ungoogled-chromium-binaries.git
cd ungoogled-chromium-binaries
git remote add upstream https://github.com/ungoogled-software/ungoogled-chromium-binaries.git
git config branch.master.remote upstream
git config branch.master.pushRemote origin

发布二进制文件：

以下示例演示了发布位于 /home/user/ungoogled-chromium/build/（假设其为 ~/ungoogled-chromium/build/ 的 shell 展开形式）中的 Debian 9 (buster) amd64 软件包，用于 ungoogled-chromium 版本 99.0.1234.567-1：

# In GitHub, create a new Release on YOURNAME/ungoogled-chromium-binaries with a name "99.0.1234.567-1" (without quotes) and a new tag "99.0.1234.567-1" (without quotes; insert it into the tag field). Upload all necessary files from /home/user/ungoogled-chromium/buildspace/ into the Release.
cd ungoogled-chromium-binaries # The same as the one setup above
git pull
# Create the directories debian/ and debian/buster_amd64 with corresponding display_name files in config/platforms/ ONLY if they do NOT exist.
# NOTE: You can use either --git to fetch the latest tag on the current branch, or specify it manually with --tag
./utilities/submit_github_binary.py --git path/to/ungoogled-chromium-debian --username YOURNAME --output config/platforms/debian/buster_amd64/ ~/ungoogled-chromium/build/ungoogled-chromium*
# A commit will be created automatically. Ensure commits are correct before proceeding
git push
# In GitHub, create a pull request in ungoogled-software/ungoogled-chromium-binaries with the new change in YOURNAME/ungoogled-chromium-binaries

测试更改

python3 -m pip install -r utilities/requirements.txt
python3 utilities/site_generator.py
./utilities/local_server.py
# Open a webpage to http://localhost:8086

外部资源

• github-markdown-css
• PyAtom