# devtools

**Repository Path**: openharmony-loongarch/devtools

## Basic Information

- **Project Name**: devtools
- **Description**: Devtools for Openhamony LoongArch
- **Primary Language**: Shell
- **License**: GPL-2.0
- **Default Branch**: ohos-main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 2
- **Created**: 2024-05-22
- **Last Updated**: 2025-06-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 开源鸿蒙(OHOS)龙架构(LoongArch)主线移植项目

**开源鸿蒙5.1版本**： 请阅读[此文档](https://gitee.com/openharmony-loongarch/devtools/blob/ohos-5.1/README.md)

完整仓库由 2 部分组成：

1. 不需要增加龙架构补丁的，直接使用上游的 `master` 分支。
2. 需要增加龙架构补丁的， 会 fork 到本组织中，并基于上游的 `master` 分支打补丁，并命名为 `ohos-main` 分支。

fork 仓库的 `ohos-main` 分支，可能会落后于主线 `master` 分支，在持续向上游提交补丁过程中，会不定期 rebase，并解决问题。

具体仓库列表可参见文件： https://gitee.com/openharmony-loongarch/manifest/blob/ohos-main/loongarch.xml

## 一、开发环境准备

以下 A、B 两种方式可任选其中一种：

### A. 方式一(手动)

1. 创建项目目录 `openharmony_loongarch`，并进入此目录

```
mkdir openharmony_loongarch
cd openharmony_loongarch
```

2. 安装 repo 命令

如果发行版仓库没有的话，可从此处下载 repo, 并保存在 PATH 环境变量所指定的目录中

```
export PATH=~/bin:$PATH
mkdir -p ~/bin/
curl https://gitee.com/oschina/repo/raw/main/repo -o ~/bin/repo
chmod +x ~/bin/repo

```

3. 下载代码

```
repo init -u https://gitee.com/openharmony-loongarch/manifest.git -b ohos-main -m loongarch.xml --no-repo-verify -v
repo sync -c
repo forall -c 'git lfs pull'
```

4.  执行预编译下载，安装编译工具链及Sdk。

```
./build/prebuilts_download.sh
```


### B. 方式二(自动)

将方式一的操作步骤自动化，自动下载 OHOS 源码及支持 LoongArch 架构的工具链，只需运行下面这条命令：

```
$ curl -s -k https://gitee.com/openharmony-loongarch/devtools/raw/ohos-main/start.sh | bash -
```

## 二、编译项目

1. 编译虚拟机镜像

最小化标准系统虚拟机镜像移植，运行以下命令开始编译：

```
./build.sh --product-name qemu-loongarch64-linux-min --ccache --gn-args ohos_extra_cppflags="-Wno-format"
```

2. 编译 ohos-sdk

OpenHarmony全量接口的SDK，运行以下命令开始编译：

```
./build.sh --product-name ohos-sdk --gn-args ohos_extra_cppflags="-Wno-format"
```

3. 编译龙架构PC镜像

使用 3A5000/3A6000 CPU 的 7A 系列主板标准 PC 系统，运行以下命令开始编译：

```
./build.sh --product-name ls3a5000@loongson --ccache --gn-args ohos_extra_cppflags="-Wno-format"
```

## 三、镜像安装测试

待补充

## 四、主线合并进度跟踪

[跟踪链接](https://gitee.com/openharmony-loongarch/devtools/issues/IBN2XK)