原創(chuàng)首發(fā)于飛書文檔由此訪問：
2020年最后一天的幾個(gè)小時(shí)庆揪，點(diǎn)上一根香，泡好茶冗栗，帶上降噪耳機(jī)在音樂的陪伴下寫寫代碼莱褒。
2020年第一天白华，沒搞完的繼續(xù)搞，加油~
開發(fā)環(huán)境的搭建
1泽谨、系統(tǒng)是MacOS碧囊，安裝Node.js倡鲸，安裝的同時(shí)也會(huì)安裝好npm 下載地址 常用命令如下：
# 查看Node.js版本
node -v
# 查看npm版本
npm -v
# 查看node安裝目錄
which node
# 更新已安裝的npm庫
npm update -g
# 全局安裝n命令供嚎，用n命令升級Node.js
npm install -g n
# 升級到最新穩(wěn)定版
n stable
# 升級到最新版
n latest
# 升級到指定版
n v14.15.3
# 切換使用版本
n 14.15.3 (ENTER)
2、安裝命令行工具
curl -L https://sf1-scmcdn-tos.pstatp.com/obj/larkdeveloper/opdev/scripts/install_1.7.0.sh | sh
3峭状、安裝完成后克滴，執(zhí)行以下命令校驗(yàn)是否安裝成功
# 是否安裝成功
opdev help
# 檢查安裝的版本
opdev --version
# 查看單個(gè)命令幫助信息，如上傳命令
opdev upload --help
4优床、上傳劝赔、預(yù)等操作需要先登錄飛書賬號，輸入以下命令會(huì)打開默認(rèn)瀏覽器進(jìn)行登錄胆敞。
這個(gè)地方比較坑着帽，不知道是工具兼容的問題還是什么，嘗試多次失敗后關(guān)閉終端重新打開才ok移层。
# 登錄
opdev login
# 選擇要登錄的環(huán)境仍翰，在這里我們選擇“Feishu”
5、登陸成功观话，返回終端予借，顯示以下信息，說明登錄成功频蛔。
創(chuàng)建第一個(gè)小程序
1灵迫、進(jìn)入飛書開發(fā)者后臺(tái)，創(chuàng)建一個(gè)企業(yè)自建應(yīng)用
2晦溪、在企業(yè)自建應(yīng)用列表中點(diǎn)擊剛才創(chuàng)建的HelloWorld應(yīng)用進(jìn)入應(yīng)用詳情頁
3瀑粥、在應(yīng)用詳情頁中，點(diǎn)擊左側(cè)“憑證與基礎(chǔ)信息”標(biāo)簽三圆，查看右側(cè)“應(yīng)用憑證”下的App ID（App ID 是應(yīng)用的唯一標(biāo)識）并復(fù)制狞换。
4、從內(nèi)置模板中生成一個(gè)“HelloWord”的小程序Demo
# 查看內(nèi)置模版列表
opdev template
# 返回結(jié)果嫌术，自帶5個(gè)Demo
# Available templates:
# - hello-world Gadget base template
# - gadget-demo Gadget api/component demo
# - widget-demo-approve Widget demo for Approve app
# - widget-demo-report Widget Demo for Report app
# - block-demo Block base template
# 用內(nèi)置模版創(chuàng)建小程序Demo, [project-path]為Demo目錄
opdev new [project-path] -t hello-world
5哀澈、編輯“project.config.json”中的第9行牌借，將剛才復(fù)制的App ID填入度气，保存退出。
{
"setting": {
"urlCheck": true,
"es6": true,
"postcss": true,
"minified": true,
"newFeature": true
},
"appid": "XXXXXXXXXXXXXX",
"projectname": "Hello World"
}
6膨报、回到命令行磷籍，執(zhí)行“opdev devtools Demo1 ”命令适荣，會(huì)打開左右兩個(gè) Chrome 瀏覽器窗口。
7弛矛、回到代碼編輯器，打開 /pages/index/index.ttml比然，修改其中的內(nèi)容并保存丈氓。
8强法、再次預(yù)覽万俗，如果看到下面的結(jié)果，那就證明本地預(yù)覽和調(diào)試的方法你已經(jīng)掌握了饮怯。
9、因?yàn)楸镜厥腔贑hrome的模擬預(yù)覽蓖墅，還可以通過真機(jī)預(yù)覽來查看小程序的真實(shí)效果
opdev preview Demo1 -p Mobile
正常應(yīng)該返回一個(gè)二維碼库倘，通過飛書客戶端掃碼即可實(shí)現(xiàn)預(yù)覽
注意：這個(gè)地方容易出現(xiàn)問題，報(bào)錯(cuò)信息如下
原因是當(dāng)前登錄用戶沒有node_modules目錄的權(quán)限论矾，因?yàn)楫?dāng)時(shí)安裝node是用的root賬戶教翩。
解決方法：
# 其中XXXX替換成你當(dāng)前的用戶
sudo chown -R XXXX /usr/local/lib/node_modules
上傳和發(fā)布小程序
1、進(jìn)入命令行拇囊，執(zhí)行以下命令迂曲，-p Mobile 標(biāo)識上傳移動(dòng)端小程序版本，輸入版本號和描述
復(fù)制下圖紅色框出現(xiàn)的網(wǎng)址在瀏覽器中打開
2寥袭、打開 啟用小程序 開關(guān)路捧、選擇最新小程序的版本、點(diǎn)擊保存按鈕传黄，確認(rèn)保存成功杰扫。
3、發(fā)布應(yīng)用膘掰，在此之前章姓，需要確保小程序的圖標(biāo)已經(jīng)設(shè)置好。點(diǎn)擊左側(cè) 版本管理與發(fā)布 進(jìn)入版本管理與發(fā)布頁面识埋，點(diǎn)擊 創(chuàng)建版本 按鈕凡伊，進(jìn)入創(chuàng)建版本詳情頁。
4窒舟、填寫完信息后系忙，選擇“申請發(fā)布”
5、在飛書客戶端會(huì)給企業(yè)管理員發(fā)信息審核惠豺，發(fā)送信息的是“開發(fā)者小助手（原開放平臺(tái)助手）”
6银还、點(diǎn)擊“去審核”后進(jìn)入“飛書管理后臺(tái)”-“應(yīng)用審核”-在右側(cè)點(diǎn)擊“審核”按鈕
7风宁、點(diǎn)擊“通過”按鈕完成應(yīng)用審核
8、完成審核后蛹疯，可以在“版本管理與發(fā)布”中看到版本狀態(tài)為“已上架”
9戒财、打開飛書客戶端，進(jìn)入工作臺(tái)捺弦，可以看到剛才發(fā)布的“HelloWorld”小程序饮寞，點(diǎn)擊可以打開應(yīng)用。
10列吼、好了骂际，搞定，第一個(gè)飛書小程序冈欢，過程中還是遇到一些問題的歉铝，但結(jié)果還是好的。
2021新年第一天凑耻，祝大家新年快樂太示。
歡迎聯(lián)系作者一起交流飛書開發(fā)經(jīng)驗(yàn)。
