開發
安裝
在現有的 React 應用中使用
yarn install clipcc-gui@latest
或者
yarn install https://github.com/Clipteam/clipcc-gui.git
下載源碼並運行
git clone https://github.com/Clipteam/clipcc-gui.git
cd clipcc-gui
yarn install
yarn start
然後前往 http://localhost:8601/查看運行輸出
如果你想要編輯clipcc-vm或clipcc-block，請使用 yarn link
# 請先在工作目錄中clone你需要的倉庫
cd clipcc-vm && yarn && yarn link
cd clipcc-block && yarn
# 編譯clipcc-block並link它，需要Python 3
yarn build
yarn link
# ...
cd clipcc-gui
yarn link clipcc-vm clipcc-block
yarn start
note
只有 clipcc-vm 和 clipcc-gui 支持熱重載
如果你需要在其他應用中引用 clipcc-gui 的本地副本，你需要先執行 yarn build:dist
你也可以使用Yarn工作區, 詳情點此
和原版 Scratch 的區別
- clipcc-gui 使用 React 17.0.2 而不是 React 16.2
- clipcc-block 重寫了編譯腳本以使用 Python3，並可以在 Windows 上運行
- 切換包管理器為 Yarn
測試
文檔
到jest cli docs來查看更多選項
執行測試
筆記: 如果你是Windows使用者，請在Windows的cmd.exe 執行而不是Git Bash/MINGW64.
在執行任何程式前，請先確保有先在這個資料夾(clipcc-gui)的最頂層執行yarn install。
主要測試指令
一次執行Tlinter, unit tests, build，和integration tests
yarn test
執行單位測試
單獨運行單元測試：
yarn run test:unit
在監視模式下運行單元測試（監視代碼更變並持續運行測試):
yarn run test:unit -- --watch
您可以運行單個集成測試文件（在此示例中執行按鈕測試）：
$(yarn bin)/jest --runInBand test/unit/components/button.test.jsx
運行集成測試
集成測試使用無頭瀏覽器來操作repo中實際的HTML和javascript。
您將看不到此動作（儘管在播放聲音時您可以聽到它！）。
請注意，集成測試要求您首先創建一個可以在瀏覽器中加載的構建：
yarn run build
接著，你可以執行所有集成測試:
yarn run test:integration
或是你可以執行集成測試中的單個文件 (在這個範例中使用backpack 測試):
$(yarn bin)/jest --runInBand test/integration/backpack.test.js
如果你想用瀏覽器監視測試，請在後面添加參數
USE_HEADLESS=no $(yarn bin)/jest --runInBand test/integration/backpack.test.js
常見問題
Ignoring optional dependencies
執行 yarn install可能會收到關於optional的警告
npm WARN optional Skipping failed optional dependency /chokidar/fsevents:
npm WARN notsup Not compatible with your operating system or architecture: fsevents@1.2.7
可以在後面添加 no-optional 參數解決此問題:
yarn install --no-optional
參見: Stack Overflow
Resolving dependencies
第一次安裝時可能會收到以下警告
npm WARN eslint-config-scratch@5.0.0 requires a peer of babel-eslint@^8.0.1 but none was installed.
npm WARN eslint-config-scratch@5.0.0 requires a peer of eslint@^4.0 but none was installed.
npm WARN scratch-paint@0.2.0-prerelease.20190318170811 requires a peer of react-intl-redux@^0.7 but none was installed.
npm WARN scratch-paint@0.2.0-prerelease.20190318170811 requires a peer of react-responsive@^4 but none was installed.
你可以檢查那些版本是支援的:
yarn view react-intl-redux@0.* version
你會需要安裝指定版本:
yarn install --no-optional --save-dev react-intl-redux@^0.7
依賴的套件可能會依賴依賴的套件所依賴的套件。 如果依賴的套件缺少依賴的套件所依賴的套件，你會收到以下警告: 反正就是你缺套件
user@machine:~/sources/scratch/clipcc-gui (491-translatable-library-objects)$ yarn install --no-optional --save-dev react-intl-redux@^0.7
clipcc-gui@0.1.0 /media/cuideigin/Linux/sources/scratch/clipcc-gui
├── react-intl-redux@0.7.0
└── UNMET PEER DEPENDENCY react-responsive@5.0.0
你也會需要安裝這些套件所依賴的套件:
yarn install --no-optional --save-dev react-responsive@^5.0.0
參見: Stack Overflow
