# Aloha-Xromium

**Repository Path**: ordinaryAnton/aloha-xromium

## Basic Information

- **Project Name**: Aloha-Xromium
- **Description**: 基于 Chromium 定制的浏览器。
（本仓库不包含 Chromium 主代码，需要独立拉取 Chromium 源码）
- **Primary Language**: C++
- **License**: BSD-3-Clause
- **Default Branch**: master
- **Homepage**: https://blog.csdn.net/yyy11280335/category_12904673.html?fromshare=blogcolumn&sharetype=blogcolumn&sharerId=12904673&sharerefer=PC&sharesource=yyy11280335&sharefrom=from_link
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-02-27
- **Last Updated**: 2025-08-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Chromium

## README

# ![Aloha logo](resources/app_icons/aloha.ico)**Aloha - Xromium**

## 简介

基于 Chromium 二次定制开发的浏览器

## 编译/运行方法

1. 在 chromium 源代码目录下（`src` 目录）拉取 `aloha` 仓库：

   1. ```bash
      # github:
      git clone https://github.com/5330-git/Aloha-xromium.git aloha
      # 国内可以拉取 gitee 的地址：
      git clone https://gitee.com/ordinaryAnton/aloha-xromium.git aloha
      ```
2. 运行补丁脚本将必要更改打入 chromium 代码中

   1. ```bash
      python aloha/tools/patcher/runme.py -a
      ```
   2. 此外还可以选择手动补丁
      1. ```bash
         # 切换到 chromium 根目录下
         git apply aloha/aloha.patch
         ```
3. 编译前端资源

   1. 前端资源主要是 `aloha\resources\browser` 目录下的两个子目录，都是使用 vue + vite 开发的，可以切换到这两个目录下分别执行构建命令：
      ```bash
      pnpm install
      pnpm run build
      ```
   2. 另外前端资源的构建已经集成到 GN 流程中，可以使用下面的命令构建前端资源
      ```bash
       autoninja -C out/Default aloha/resources/browser:build_webapp_resources
      ```
4. 编译浏览器客户端

   1. 确保切换到 chromium 代码的 src 根目录下，执行下面的命令

      ```bash
      gn gen out/Default
      autoninja -C out/Default aloha
      ```
   2. 可以在 `out/Default/args.gn` 中添加编译参数（详细配置可以参考[GN build configuration](https://www.chromium.org/developers/gn-build-configuration/)），以下是 Debug 模式的配置参数demo:

      ```ini
      # Set build arguments here. See `gn help buildargs`.
      is_debug=true
      # component 模块会以 shared library 的形式编译
      is_component_build=true
      # enable html5 media player
      ffmpeg_branding = "Chrome"
      proprietary_codecs = true
      ```
   3. 也可以通过下面的命令同时编译浏览器客户端和前端资源：

   ```bash
   gn gen out/Default
   autoninja -C out/Default aloha-all
   ```
5. 客户端程序打包，这会生成一个包含所有 `aloha` 本体以及其所有依赖的压缩包

   ```bash
   autoninja -C out/Default aloha/installer:aloha_mini_install_packer   
   ```

## 博客链接

[【一】从0定制浏览器：引言-CSDN博客](https://blog.csdn.net/yyy11280335/article/details/145891351?spm=1001.2014.3001.5502)

[【二】从0定制浏览器：修复HTML5播放器问题并引入 Native Views-CSDN博客](https://blog.csdn.net/yyy11280335/article/details/145899706?spm=1001.2014.3001.5502)

[【间章一】从0定制浏览器：实现脚本工具管理耦合Chromium的代码更改-CSDN博客](https://blog.csdn.net/yyy11280335/article/details/145921616?spm=1001.2014.3001.5501)

[【三】从0定制浏览器：Tab UI 交互优化以及添加程序图标-CSDN博客](https://blog.csdn.net/yyy11280335/article/details/146159997?spm=1001.2014.3001.5501)

[【四】从0定制浏览器：增加 Cookies 持久化支持-CSDN博客](https://blog.csdn.net/yyy11280335/article/details/146232877?spm=1001.2014.3001.5501)

[【五】从0定制浏览器：注册自定义协议并处理请求-CSDN博客](https://blog.csdn.net/yyy11280335/article/details/146407369?spm=1001.2014.3001.5502)