本文主要大致介紹一個靜態 html 專案如何構建為 blocklet 並打包發布到商店,閱讀本文之前請先安裝 Blocklet CLI 環境,安裝 Blocklet CLI 可參考官方文檔
已上傳油管視頻:https://www.youtube.com/watch?v=0gLtAos1WS0
一、尋找靜態 html 專案
可以是自己的 html 專案,或者可在 github 上尋找感興趣的開源的 html 專案,本文以為例,其他貪吃蛇、掃雷等小遊戲的 html 也可以
下載專案 zip 文件並解壓
二、初始化 blocklet
從步驟一可得到一個專案的文件夾(假設文件夾名為 jump)
#跳轉到文件夾目錄,以各自實際情況做修改
cd jump
#初始化 blockelt
blocklet init
期間需要填寫一些基本信息,如下圖,填寫完成後,會彈出瀏覽器窗口,需要連接錢包到官方商店生成應用 did
三、驗證和打包
1、運行驗證
#運行驗證 html 專案是否正常
blocklet dev
執行成功後,會得到如下圖的應用鏈接,複製網址到瀏覽器驗證是否正常
2、打包
運行驗證正常後,打包之前可以先配置一些專案信息,使得整個專案看起來正式一點
主要關注 blocklet.yml 、blocklet.md ,字段對應商店應用信息可看截圖
按照 @shijun 提及的如果是從 open source repo 構建的專案:
請在 blocklet.yml 裡面註明出處
請確保專案的 licence 沒有問題,避免侵權
另外,後續靜態 html 專案需要在 blocklet.yml 配置一個依賴
engine:
interpreter: blocklet
source:
store: https://store.blocklet.dev
name: z2qa2dGC9EmsjB2WJtUcmuRWx43zTwPUZQF7g
version: latest
開源專案請在 blocklet.yml 標明出處
repository:
type: git
url: git+https://github.com/blocklet/html-2048-sample.git
專案基礎信息配置完成後,開始打包
blocklet bundle --zip --create-release
四、發布
發布之前,首先要有 blocklet store 的 dev 通行證,可以自行啟動 blocklet store 或向官方商店申請 dev 通行證(可私聊專案方)
擁有 dev 通行證後,可到該頁面申請密鑰,並執行截圖中命令行
#配置商店信息(以下信息示例,以實際複製內容為準)
blocklet config set accessToken z2K8qz2DdixZUoTuYLUf5wBDWy**************snhaJHpC5YwGjii8SvunJrDGxk9n
blocklet config set store https://test.store.blocklet.dev
blocklet config set developerDid z1XwQif7VXcM****SksVC3sgqKtfR8
#上傳到商店
blocklet upload
上傳成功後,還需要到 blocklet store 的後台進行發布,首次發布需要進行質押,示例中用到的商店是官方的測試商店 ,需要使用 5 個 TBA,可到水龍頭免費領取
發布成功後,即可在商店首頁看到