提交 fc7d9f98 编写于 作者: A annie_wangli

update docs

Signed-off-by: Nannie_wangli <annie.wangli@huawei.com>
### 0.0.5(2021/10/28)
新增安装tar、binutils、git-lfs、gnutls-bin、python3.8、python3-pip、cpio。
### 0.0.4(2021/09/18)
1、删除编译依赖的工具预装。
......
### 0.0.5(2021/10/28)
Added the installation of tar, binutils, git-lfs, gnutls-bin, python3.8, python3-pip and cpio.
### 0.0.4(2021/09/18)
1\. dropped pre-installed build dependency tools.
......
......@@ -10,11 +10,11 @@ The Docker image of OpenHarmony is hosted on [HUAWEI Cloud SWR](https://auth.hua
1. Obtain the Docker image.
```
docker pull swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker-standard:0.0.4
docker pull swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker-standard:0.0.5
```
2. Go to the root directory of OpenHarmony code and run the following command to access the Docker build environment:
```
docker run -it -v $(pwd):/home/openharmony swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker-standard:0.0.4
docker run -it -v $(pwd):/home/openharmony swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker-standard:0.0.5
```
##### **Method 2: Using the Dockerfile to Build a Local Docker Image**
......@@ -30,7 +30,7 @@ cd docs/docker/standard
```
3. Go to the root directory of OpenHarmony code and run the following command to access the Docker build environment:
```
docker run -it -v $(pwd):/home/openharmony openharmony-docker-standard:0.0.4
docker run -it -v $(pwd):/home/openharmony openharmony-docker-standard:0.0.5
```
### Building for Standard-System Devices (reference memory ≥ 128 MB)
......
......@@ -10,11 +10,11 @@ OpenHarmony的Docker镜像托管在HuaweiCloud SWR上。开发者可以通过该
1. 获取Docker镜像。
```
docker pull swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker-standard:0.0.4
docker pull swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker-standard:0.0.5
```
2. 进入OpenHarmony代码根目录执行如下命令,从而进入Docker构建环境。
```
docker run -it -v $(pwd):/home/openharmony swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker-standard:0.0.4
docker run -it -v $(pwd):/home/openharmony swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker-standard:0.0.5
```
##### 方式二:通过Dockerfile 构建本地Docker镜像进行构建
......@@ -30,7 +30,7 @@ cd docs/docker/standard
```
3. 进入OpenHarmony代码根目录执行如下命令,从而进入Docker构建环境。
```
docker run -it -v $(pwd):/home/openharmony openharmony-docker-standard:0.0.4
docker run -it -v $(pwd):/home/openharmony openharmony-docker-standard:0.0.5
```
### 编译源码-标准系统类设备(参考内存≥128MB)
......
......@@ -13,4 +13,4 @@
#!/bin/sh
docker build -t openharmony-docker-standard:0.0.4 .
docker build -t openharmony-docker-standard:0.0.5 .
......@@ -26,6 +26,8 @@ RUN apt-get update \
&& apt-get install -y \
apt-utils \
vim \
tar \
binutils \
software-properties-common \
openssh-server \
iputils-ping \
......@@ -68,6 +70,7 @@ RUN apt-get update \
bison \
doxygen \
git \
git-lfs \
subversion \
tofrodos \
pigz \
......@@ -83,6 +86,10 @@ RUN apt-get update \
lib32z-dev \
openjdk-8-jdk \
ruby \
gnutls-bin \
python3.8 \
python3-pip \
cpio \
&& rm -rf /bin/sh \
&& ln -s /bin/bash /bin/sh \
&& mkdir -p $PREBUILTS_DIR/prebuilts $HOME_TOOLS
......
......@@ -52,7 +52,7 @@ OpenHarmony provides the following two types of Docker environments for you to q
</td>
<td class="cellrowborder" valign="top" headers="mcps1.2.6.1.3 "><p id="p552616549297"><a name="p552616549297"></a><a name="p552616549297"></a>swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker-standard</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.2.6.1.4 "><p id="p1633303300"><a name="p1633303300"></a><a name="p1633303300"></a>0.0.4</p>
<td class="cellrowborder" valign="top" headers="mcps1.2.6.1.4 "><p id="p1633303300"><a name="p1633303300"></a><a name="p1633303300"></a>0.0.5</p>
</td>
</tr>
<tr id="row5986201731214"><td class="cellrowborder" align="center" valign="top" width="15.831583158315832%" headers="mcps1.2.6.1.1 "><p id="p136981216143"><a name="p136981216143"></a><a name="p136981216143"></a>HPM-based Docker environment</p>
......@@ -70,6 +70,7 @@ OpenHarmony provides the following two types of Docker environments for you to q
</table>
## Preparations<a name="section7337134183512"></a>
Before using the Docker environment, perform the following operations:
......@@ -179,13 +180,13 @@ hb set
1. Obtain the Docker image.
```
docker pull swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker-standard:0.0.4
docker pull swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker-standard:0.0.5
```
2. Go to the root directory of OpenHarmony code and run the following command to access the Docker build environment:
```
docker run -it -v $(pwd):/home/openharmony swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker-standard:0.0.4
docker run -it -v $(pwd):/home/openharmony swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker-standard:0.0.5
```
......@@ -207,7 +208,7 @@ hb set
3. Go to the root directory of OpenHarmony code and run the following command to access the Docker build environment:
```
docker run -it -v $(pwd):/home/openharmony openharmony-docker-standard:0.0.4
docker run -it -v $(pwd):/home/openharmony openharmony-docker-standard:0.0.5
```
......
......@@ -257,7 +257,7 @@ To build such an app, we can create a page that has a flexible layout with two r
## Signing and Packaging<a name="section10601181101516"></a>
After finishing writing the app code, you need to sign and package the app before running it on a real device. For details, see [Signing and Packaging Guide](../../application-dev/quick-start/configuring-the-openharmony-app-signature.md).
After finishing writing the app code, you need to sign and package the app before running it on a real device. For details, see [Configuring the OpenHarmony App Signature](../../application-dev/quick-start/configuring-the-openharmony-app-signature.md).
## Running on the Real Device<a name="section092721731511"></a>
......
......@@ -63,13 +63,13 @@ bash build/prebuilts_download.sh
1. Obtain the Docker image.
```
docker pull swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker-standard:0.0.4
docker pull swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker-standard:0.0.5
```
2. Go to the root directory of OpenHarmony code and run the following command to access the Docker build environment:
```
docker run -it -v $(pwd):/home/openharmony swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker-standard:0.0.4
docker run -it -v $(pwd):/home/openharmony swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker-standard:0.0.5
```
......@@ -91,7 +91,7 @@ bash build/prebuilts_download.sh
3. Go to the root directory of OpenHarmony code and run the following command to access the Docker build environment:
```
docker run -it -v $(pwd):/home/openharmony openharmony-docker-standard:0.0.4
docker run -it -v $(pwd):/home/openharmony openharmony-docker-standard:0.0.5
```
......
......@@ -53,7 +53,7 @@ subsystem # Subsystem
│ │ ├── ivi
│ │ └── liteos-a
│ │ ...
│ └── ohos_build # Build entry configuration
│ └── ohos_build # Build entry configuration
...
```
> **Note:** Test cases are classified into common test cases and device-specific test cases. You are advised to place common test cases in the **common** directory and device-specific test cases in the directories of the related devices.
......@@ -113,12 +113,12 @@ Example:
void CalculatorSubTest::SetUp(void)
{
// Set a setup function, which will be called before all test cases.
// Set a setup function, which will be called before each test case.
}
void CalculatorSubTest::TearDown(void)
{
// Set a teardown function, which will be called after all test cases.
// Set a teardown function, which will be called after each test case.
}
/**
......@@ -186,12 +186,12 @@ Example:
void CalculatorSubTest::SetUp(void)
{
// Set a setup function, which will be called before all test cases.
// Set a setup function, which will be called before each test case.
}
void CalculatorSubTest::TearDown(void)
{
// Set a teardown function, which will be called after all test cases.
// Set a teardown function, which will be called after each test case.
}
```
> **Note**: When defining a test suite, ensure that the test suite name is the same as the target to build and uses the upper camel case style.
......@@ -279,12 +279,12 @@ Example:
})
beforeEach(function() {
// Set a setup function, which will be called before all test cases.
// Set a setup function, which will be called before each test case.
console.info('beforeEach caled')
})
afterEach(function() {
// Set a teardown function, which will be called after all test cases.
// Set a teardown function, which will be called after each test case.
console.info('afterEach caled')
})
......@@ -341,12 +341,12 @@ Example:
})
beforeEach(function() {
// Set a setup function, which will be called before all test cases.
// Set a setup function, which will be called before each test case.
console.info('beforeEach caled')
})
afterEach(function() {
// Set a teardown function, which will be called after all test cases.
// Set a teardown function, which will be called after each test case.
console.info('afterEach caled')
})
```
......@@ -757,12 +757,12 @@ When the build is complete, the test cases are automatically saved in the **out/
```
In the command:
```
-**t [TESTTYPE]**: specifies the test case type, which can be **UT**, **MST**, **ST**, or **PERF**. This parameter is mandatory.
-**tp [TESTTYPE]**: specifies a part, which can be used independently.
-**tm [TESTTYPE]**: specifies a module. This parameter must be specified together with **-tp**.
-**ts [TESTTYPE]**: specifies a test suite, which can be used independently.
-**tc [TESTTYPE]**: specifies a test case. This parameter must be specified together with **-ts**.
-You can run **h** to display help information.
-t [TESTTYPE]: specifies the test case type, which can be UT, MST, ST, or PERF. This parameter is mandatory.
-tp [TESTTYPE]: specifies a part, which can be used independently.
-tm [TESTTYPE]: specifies a module. This parameter must be specified together with -tp.
-ts [TESTTYPE]: specifies a test suite, which can be used independently.
-tc [TESTTYPE]: specifies a test case. This parameter must be specified together with -ts.
You can run -h to display help information.
```
### Executing Test Cases on Linux
#### Mapping Remote Port
......@@ -797,12 +797,12 @@ To enable test cases to be executed on a remote Linux server or a Linux VM, map
```
In the command:
```
-**t [TESTTYPE]**: specifies the test case type, which can be **UT**, **MST**, **ST**, or **PERF**. This parameter is mandatory.
-**tp [TESTTYPE]**: specifies a part, which can be used independently.
-**tm [TESTTYPE]**: specifies a module. This parameter must be specified together with **-tp**.
-**ts [TESTTYPE]**: specifies a test suite, which can be used independently.
-**tc [TESTTYPE]**: specifies a test case. This parameter must be specified together with **-ts**.
-You can run **h** to display help information.
-t [TESTTYPE]: specifies the test case type, which can be UT, MST, ST, or PERF. This parameter is mandatory.
-tp [TESTTYPE]: specifies a part, which can be used independently.
-tm [TESTTYPE]: specifies a module. This parameter must be specified together with -tp.
-ts [TESTTYPE]: specifies a test suite, which can be used independently.
-tc [TESTTYPE]: specifies a test case. This parameter must be specified together with -ts.
You can run -h to display help information.
```
## Viewing the Test Report
......
......@@ -39,7 +39,7 @@
## 导入模块<a name="zh-cn_topic_0000001149710363_section749mcpsimp"></a>
```
import client from 'libupdateclient.z.so'
import client from '@ohos.update'
```
## 权限列表<a name="zh-cn_topic_0000001149710363_section752mcpsimp"></a>
......
......@@ -52,7 +52,7 @@ OpenHarmony为开发者提供了两种Docker环境,以帮助开发者快速完
</td>
<td class="cellrowborder" valign="top" headers="mcps1.2.6.1.3 "><p id="p552616549297"><a name="p552616549297"></a><a name="p552616549297"></a>swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker-standard</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.2.6.1.4 "><p id="p1633303300"><a name="p1633303300"></a><a name="p1633303300"></a>0.0.4</p>
<td class="cellrowborder" valign="top" headers="mcps1.2.6.1.4 "><p id="p1633303300"><a name="p1633303300"></a><a name="p1633303300"></a>0.0.5</p>
</td>
</tr>
<tr id="row5986201731214"><td class="cellrowborder" align="center" valign="top" width="15.831583158315832%" headers="mcps1.2.6.1.1 "><p id="p136981216143"><a name="p136981216143"></a><a name="p136981216143"></a>HPM Docker环境</p>
......@@ -70,6 +70,7 @@ OpenHarmony为开发者提供了两种Docker环境,以帮助开发者快速完
</table>
## 环境准备<a name="section7337134183512"></a>
在使用docker环境前需要先完成以下操作:
......@@ -179,13 +180,13 @@ hb set
1. 获取Docker镜像。
```
docker pull swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker-standard:0.0.4
docker pull swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker-standard:0.0.5
```
2. 进入OpenHarmony代码根目录执行如下命令,从而进入Docker构建环境。
```
docker run -it -v $(pwd):/home/openharmony swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker-standard:0.0.4
docker run -it -v $(pwd):/home/openharmony swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker-standard:0.0.5
```
......@@ -207,7 +208,7 @@ hb set
3. 进入OpenHarmony代码根目录执行如下命令,从而进入Docker构建环境。
```
docker run -it -v $(pwd):/home/openharmony openharmony-docker-standard:0.0.4
docker run -it -v $(pwd):/home/openharmony openharmony-docker-standard:0.0.5
```
......
......@@ -144,7 +144,7 @@ OpenHarmony是由开放原子开源基金会(OpenAtom Foundation)孵化及
4. 查找合适的发行版,点击查看发行版的详情介绍。
**图 1** 包管理<a name="fig349416264520"></a>
![](figures/包管理.png "包管理")
![](figure/包管理.png "包管理")
2. 了解发行版详情。
......@@ -153,7 +153,7 @@ OpenHarmony是由开放原子开源基金会(OpenAtom Foundation)孵化及
3. 点击「定制组件」,将对发行版包含的组件进行定制(添加/删除)。
**图 2** 发行版示例<a name="fig142484411121"></a>
![](figures/发行版示例.png "发行版示例")
![](figure/发行版示例.png "发行版示例")
3. 定制组件。
1. 进入发行版的定制页面,如下图所示。
......@@ -162,7 +162,7 @@ OpenHarmony是由开放原子开源基金会(OpenAtom Foundation)孵化及
4. 点击“下载“,系统会根据您的选择,生成相应的OpenHarmony代码结构文件\(如my\_cust\_dist.zip\),保存至本地文件。
**图 3** 组件定制<a name="fig1256020372197"></a>
![](figures/组件定制.png "组件定制")
![](figure/组件定制.png "组件定制")
4. 安装组件。
1. 解压下载的压缩文件,用命令行工具CMD(Linux下的Shell终端)。
......
......@@ -92,7 +92,7 @@ Linux服务器通用环境配置需要的工具及其获取途径如下表所示
使用如下apt-get命令安装编译所需的必要的库和工具:
```
sudo apt-get install build-essential gcc g++ make zlib* libffi-dev e2fsprogs pkg-config flex bison perl bc openssl libssl-dev libelf-dev libc6-dev-amd64 binutils binutils-dev libdwarf-dev u-boot-tools mtd-utils gcc-arm-linux-gnueabi
sudo apt-get install build-essential gcc g++ make zlib* libffi-dev e2fsprogs pkg-config flex bison perl bc openssl libssl-dev libelf-dev libc6-dev-amd64 binutils binutils-dev libdwarf-dev u-boot-tools mtd-utils gcc-arm-linux-gnueabi cpio device-tree-compiler
```
## 安装Python3<a name="section1238412211211"></a>
......
......@@ -63,13 +63,13 @@ bash build/prebuilts_download.sh
1. 获取Docker镜像。
```
docker pull swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker-standard:0.0.4
docker pull swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker-standard:0.0.5
```
2. 进入OpenHarmony代码根目录执行如下命令,从而进入Docker构建环境。
```
docker run -it -v $(pwd):/home/openharmony swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker-standard:0.0.4
docker run -it -v $(pwd):/home/openharmony swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker-standard:0.0.5
```
......@@ -91,7 +91,7 @@ bash build/prebuilts_download.sh
3. 进入OpenHarmony代码根目录执行如下命令,从而进入Docker构建环境。
```
docker run -it -v $(pwd):/home/openharmony openharmony-docker-standard:0.0.4
docker run -it -v $(pwd):/home/openharmony openharmony-docker-standard:0.0.5
```
......
......@@ -14,7 +14,7 @@
## 简介<a name="section11660541593"></a>
OpenHarmony针对不同量级的系统,分别使用了不同形态的内核,分别为LiteOS和Linux。在轻量系统、小型系统和标准系统上,可以选用LiteOS;在小型系统和标准系统上,可以选用Linux。
OpenHarmony针对不同量级的系统,分别使用了不同形态的内核,分别为LiteOS和Linux。在轻量系统、小型系统可以选用LiteOS;在小型系统和标准系统上可以选用Linux。
<a name="table91002058194612"></a>
<table><thead align="left"><tr id="row010015589464"><th class="cellrowborder" valign="top" width="25%" id="mcps1.2.5.1.1"><p id="p310015824612"><a name="p310015824612"></a><a name="p310015824612"></a>系统级别</p>
......@@ -33,7 +33,7 @@ OpenHarmony针对不同量级的系统,分别使用了不同形态的内核,
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.2.5.1.3 "><p id="p15762194124714"><a name="p15762194124714"></a><a name="p15762194124714"></a></p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.2.5.1.4 "><p id="p647872125416"><a name="p647872125416"></a><a name="p647872125416"></a></p>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.2.5.1.4 "><p id="p647872125416"><a name="p647872125416"></a><a name="p647872125416"></a>×</p>
</td>
</tr>
<tr id="row15104331164711"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.2.5.1.1 "><p id="p15104163120477"><a name="p15104163120477"></a><a name="p15104163120477"></a>Linux</p>
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册