pxt microbit

Micro：PXT的位目標

PXT-Microbit是Microsoft編程體驗工具包（PXT）目標，它允許您對BBC Micro：BIT進行編程。

• pxt-microbit beta ， v3.0.*要求

  • pxt-microbit＃stable3.0
  • pxt＃stable6.0。
  • pxt-common包裝＃stable6.0。

• pxt-microbit v2.0.* ，分支stable2.0 ，需要pxt v5.15。 *。這是現場編輯的服務分支。

• PXT-Microbit v1.*需要PXT V4.4，該V4.4當前位於PXT的穩定4.4分支中。

• pxt-microbit v0.*在此存儲庫的V0分支中

• 嘗試現場

問題跟踪

如果您發現（未報告）錯誤，請添加問題。

開發新的擴展

可以直接從Web編輯器完成新擴展的創作和測試。請參閱我們有關如何開始的文檔。如果您想在本地運行編輯器，請繼續閱讀。

本地服務器設置

本地服務器可讓您運行編輯器並從自己的計算機上提供文檔。它是針對使用的單個開發人員，而不是為大量用戶提供編輯器的設計。

1. 安裝Node.js 8.9.4或更高。
2. 克隆這個存儲庫。

 git clone https://github.com/microsoft/pxt-microbit
cd pxt-microbit

3. 安裝PXT命令行（為Mac/Linux Shell添加sudo ）。

 npm install -g pxt

4. 安裝PXT-Microbit依賴性。

 npm install

轉到運行部分。

開發人員設置

這是Makecode團隊使用的典型設置，用於在微型機構上工作。

1. 安裝Node.js 8.9.4或更高。
2. 如果您打算構建.cpp文件，請安裝Docker。
3. 克隆PXT存儲庫。

 git clone https://github.com/microsoft/pxt
cd pxt

4. 安裝PXT的依賴關係並構建

 npm install
npm run build
cd ..

5. 克隆pxt-common-capkages存儲庫

 git clone https://github.com/microsoft/pxt-common-packages
cd pxt-common-packages
npm install

6. 將pxt-common包裝鏈接到pxt

 npm link ../pxt
cd ..

7. 克隆這個存儲庫。

 git clone https://github.com/microsoft/pxt-microbit
cd pxt-microbit

8. 安裝PXT命令行（為Mac/Linux Shell添加sudo ）。

 npm install -g pxt

9. 安裝PXT-Microbit依賴性。

 npm install

10. 鏈接pxt-microbit返回基本pxt repo（為Mac/Linux Shell添加sudo ）。僅當您打算更改PXT和/或PXT-Common-Packages Repos時，才需要此步驟。如果您想要的只是為當地的makecode提供服務，則可以跳過此步驟。

 npm link ../pxt ../pxt-common-packages

注意以上命令假設文件夾結構

       makecode
          |
  ----------------------------------
  |       |                        |
 pxt      pxt-common-packages  pxt-microbit

跑步

從pxt-microbit內部運行此命令以打開本地Web服務器

 pxt serve

如果本地服務器在錯誤的瀏覽器中打開，請確保複製包含本地令牌的URL。否則，編輯者將無法加載項目。

如果您需要修改.cpp文件（並已安裝了Yotta），請使用--localbuild標誌啟用Yotta彙編：

 pxt serve --local

如果您想加快構建速度，則可以使用rebundle選項，該選項跳過構建並簡單地刷新目標信息

 pxt serve --rebundle

打掃

有時，您的構建文件夾可能處於不良狀態，將其清潔並重試。

 pxt clean

與當地建造

以下命令迫使使用代號的本地構建。

 pxt buildtarget --local

禁用Docker，運行

 export PXT_NODOCKER=1

如果您還在修改代碼，請考慮運行pxt clean以確保拾取適當的分支。

在本地修改DAL/CODAL

• 遵循上面的說明，直到pxt serve
• 在Local主機上打開編輯並創建一個項目
• 做export PXT_FORCE_LOCAL=1 PXT_RUNTIME_DEV=1 PXT_ASMDEBUG=1 ;您可以添加PXT_NODOCKER=1 ; pxt help對這些有幫助
• 在pxt-microbit/projects下查找項目文件夾，通常是pxt-microbit/projects/Untitled-42
• 如果您要在pxt中修改.cpp文件，請用"core": "*" "core": "file:../../libs/core" pxt.json類似地， "radio": "file:../../libs/radio"和"microphone": "file:../../libs/microphone"
• 您可以編輯main.ts以更改程序的PXT側；您也可以從Localhost編輯器進行編輯；請注意，在Local主持的編輯器中Download將產生與命令行不同的二進製文件，因為它在雲中構建並使用標記版本的codal版本
• 在該文件夾運行pxt build這將在built/下的某個地方克隆（取決於構建引擎和Docker）
• there can be an issue with exporting the variables ie PXT_FORCE, so including them in the build command can help solve issues sudo PXT_NODOCKER=1 PXT_ASMDEBUG=1 PXT_RUNTIME_DEV=1 PXT_DEBUG=1 PXT_FORCE_LOCAL=1 PXT_COMPILE_SWITCHES=csv---mbcodal pxt build
• 如果目標沒有構建，則在pxt-microbit/built/hexcache中刪除hexcache中的文件，以強迫本地構建
• 可以在pxt-microbit/projects/<your project name>/built nater binary.hex中找到構建的十六進制
• 同樣，您可以運行pxt deploy （或僅是相同的pxt ） - 它將構建並複製到MICROBIT驅動器
• 假設構建文件夾在built/codal下，請轉到built/codal/libraries並運行code *
• 在GIT選項卡中，結帳適當的分支（它們都處於我們標記版本的方式的獨立頭狀態）
• 修改文件，運行pxt ，查看效果
• 您還可以運行pxt gdb進行調試；這需要openocd
• 使用openocd的其他命令是pxt dmesg ，它轉儲DMESG(...)緩衝區和pxt heap ，可用於可視化PXT Heap（並且在某種程度上是Codal的一個）

更新dal.d.ts

 cd libs/blocksprj
rm -rf built
PXT_FORCE_LOCAL=1 PXT_COMPILE_SWITCHES=csv---mbcodal pxt build
PXT_FORCE_LOCAL=1 PXT_COMPILE_SWITCHES=csv---mbcodal pxt builddaldts
mv dal.d.ts ../core

更新

確保定期從所有存儲庫中進行更改。更多說明請訪問https://github.com/microsoft/pxt#rnunning-a-target-from-localhost

更新Markdown中的播放列表

要添加一個新的播放列表，請在/playlists.json中添加一個條目，然後再生降價（請參見下面的段落）。現在，您將擁有一個新的Markdown Gallery文件列出了可以在/targetconfig.json中引用的視頻。

獲取Google API鍵並將其存儲在GOOGLE_API_KEY環境變量（從應用程序中打開數據）。

 pxt downloadplaylists

存儲庫

PXT-Microbit目標取決於其他幾個存儲庫。主要的是：

• https://github.com/microsoft/pxt，pxt框架
• https://github.com/microsoft/pxt-common-packages，common apis across accross accross accross conders aw
• https://github.com/lancaster-university/microbit，DAL周圍的基本包裝器
• https://github.com/lancaster-university/microbit-dal

歷史

請參閱Makecode博客。

行為守則

該項目採用了Microsoft開源的行為代碼。有關更多信息，請參見《行為守則常見問題守則》或與其他問題或評論聯繫[email protected]。

商標

Microsoft，Microsoft徽標和MakeCode是Microsoft Corporation的註冊商標。它們只能按照Microsoft的商標和品牌準則在https://www.microsoft.com/en-us/legal/legal/intellectalectualproperty/trademarks/usage/usage/general.aspx上發表。如果Microsoft已發布的準則未涵蓋使用，或者您不確定，請諮詢您的法律顧問或Makecode團隊（[email protected]）。