Vant 開(kāi)發(fā)指南

介紹

感謝你使用 Vant。

以下是關(guān)于向 Vant 提交反饋或代碼的指南。在向 Vant 提交 issue 或者 PR 之前，請(qǐng)先花幾分鐘時(shí)間閱讀以下文字。

Issue 規(guī)范

• 遇到問(wèn)題時(shí)，請(qǐng)先確認(rèn)這個(gè)問(wèn)題是否已經(jīng)在 issue 中有記錄或者已被修復(fù)
• 提 issue 時(shí)，請(qǐng)用簡(jiǎn)短的語(yǔ)言描述遇到的問(wèn)題，并添加出現(xiàn)問(wèn)題時(shí)的環(huán)境和復(fù)現(xiàn)步驟

參與開(kāi)發(fā)

本地開(kāi)發(fā)

按照下面的步驟操作，即可在本地開(kāi)發(fā) Vant 組件

# 克隆倉(cāng)庫(kù)
git clone git@github.com:youzan/vant.git

# 安裝依賴(lài)
cd vant && npm run bootstrap

# 進(jìn)入開(kāi)發(fā)模式，瀏覽器訪(fǎng)問(wèn) http://localhost:8080
npm run dev

目錄結(jié)構(gòu)

• 倉(cāng)庫(kù)的組件代碼位于 src 下，每個(gè)組件一個(gè)文件夾
• docs 目錄下是文檔網(wǎng)站的代碼，本地開(kāi)發(fā)時(shí)可以在目錄下運(yùn)行 npm run dev 開(kāi)啟文檔網(wǎng)站

項(xiàng)目主要目錄如下：

vant
├─ build     # 構(gòu)建
├─ docs      # 文檔
├─ src       # 組件
├─ packages  # 子包
├─ test      # 單測(cè)
└─ types     # 類(lèi)型

添加新組件

添加新組件時(shí)，請(qǐng)按照下面的目錄結(jié)構(gòu)組織文件，并在 vant.config.js 中配置組件名稱(chēng)

src
└─ button
   ├─ demo             # 示例代碼
   ├─ test             # 單元測(cè)試
   ├─ index.js         # 組件入口
   ├─ index.less       # 組件樣式
   ├─ README.md        # 英文文檔
   └─ README.zh-CN.md  # 中文文檔

提交 PR

Pull Request 規(guī)范

• 如果遇到問(wèn)題，建議保持你的 PR 足夠小。保證一個(gè) PR 只解決一個(gè)問(wèn)題或只添加一個(gè)功能
• 當(dāng)新增組件或者修改原有組件時(shí)，記得增加或者修改測(cè)試代碼，保證代碼的穩(wěn)定
• 在 PR 中請(qǐng)?zhí)砑雍线m的描述，并關(guān)聯(lián)相關(guān)的 Issue

Pull Request 流程

1. fork 主倉(cāng)庫(kù)，如果已經(jīng) fork 過(guò)，請(qǐng)同步主倉(cāng)庫(kù)的最新代碼
2. 基于 fork 后倉(cāng)庫(kù)的 dev 分支新建一個(gè)分支，比如feature/button_color
3. 在新分支上進(jìn)行開(kāi)發(fā)，開(kāi)發(fā)完成后，提 Pull Request 到主倉(cāng)庫(kù)的 dev 分支
4. Pull Request 會(huì)在 Review 通過(guò)后被合并到主倉(cāng)庫(kù)
5. 等待 Vant 發(fā)布版本，一般是每周一次

同步最新代碼

提 Pull Request 前，請(qǐng)依照下面的流程同步主倉(cāng)庫(kù)的最新代碼

# 添加主倉(cāng)庫(kù)到 remote，作為 fork 后倉(cāng)庫(kù)的上游倉(cāng)庫(kù)
git remote add upstream https://github.com/youzan/vant.git

# 拉取主倉(cāng)庫(kù)最新代碼
git fetch upstream

# 切換至 dev 分支
git checkout dev

# 合并主倉(cāng)庫(kù)代碼
git merge upstream/dev