nearchan / manifest

1. 介绍 === FlymeOS开源项目致力于为开发者提供业界一流的ROM适配工具。

二零一五年六月三十日，FlymeOS开放适配终于来了，我们相信虽晚未迟。

2. 分支命名 === 开源项目的分支命名与Android版本对应,目前支持Android 6.0的机型适配，分支名为：marshmallow-6.0

目录结构如下所示:

FlymeOS
 +-- manifest           项目清单
 +-- tutorials          教程文档
 +-- plugins            扩展插件，用于扩展已有功能
 +-- build              编译环境，用于构建和编译机型
 +-- tools              适配工具
 +-- flyme              Flyme相关，内容定期更新
      +-- release       官方发布的ROM包
      +-- overlay       资源覆盖
 +-- devices            机型目录
      +-- base          官方提供的默认机型
      +-- your_device   待开发者适配的机型

3. 代码下载 ===

通过repo init命令的-b参数, 选择需要下载的分支。 通过repo sync命令同步远程代码:

$ repo init -u https://github.com/FlymeOS/manifest.git -b marshmallow-6.0
$ repo sync -c -j4

如果连接一直失败或下载代码过慢，则使用以下命令:

$ repo init --repo-url git://github.com/FlymeOS/repo.git \
            -u https://github.com/FlymeOS/manifest.git \
            -b marshmallow-6.0 --no-repo-verify
$ repo sync --no-clone-bundle -c -j4

4. 机型适配 === * 标准流程

下载完代码以后, 在开源项目根目录, 执行以下命令初始化开发环境:

$ source build/envsetup.sh

创建一个新的机型工程的目录(以demo为例), 后续的移植都在机型目录完成。

$ mkdir -p devices/demo
$ cd devices/demo

按照如下步骤，完成一个新机型的适配：

$ flyme config      # 生成机型配置文件Makefile
$ flyme newproject  # 生成新机型目录
$ flyme patchall    # 自动插桩
$ flyme fullota     # 生成适配完成的ROM包

* 冲突处理

自动插桩可能会造成代码合并冲突。冲突会以下面的形式标注出来, 开发者需要在厂商的文件中手工解决这些冲突。

<<<<<<< VENDOR
  原厂的代码块
=======
  Flyme的代码块
>>>>>>> BOSP

* 版本升级

可以跟随官方发布的最新ROM包，将已经是适配完成的机型升级到最新版本：

$ flyme cleanall
$ flyme upgrade

5. 贡献代码 ===

我们鼓励开发者为开源社区作出贡献。利用Github的Pull-Request机制，便可将内容变更发送给Flyme官方审阅。

• 首先，在github页面上，点击“Fork”，将Flyme的git库拷贝到自己账户
• 然后，对拷贝的git库进行修改，将内容变更提交到自己的账户
• 最后，在github页面上，点击"New pull request"，向Flyme官方发起代码审阅

6. 其他 ===

* 问题求助与反馈

• [email protected]

• [email protected]

* 已适配机型展示与下载

• http://www.flyme.cn/firmware.html