pxt arcade

使用MicrosoftMakeCode的休閒遊戲編輯器

• 嘗試https://arcade.makecode.com
• 論壇

此存儲庫包含使用MicrosoftMakeCode（PXT）構建的街機編輯器。

創建和編輯包裹

在編輯器中，您將在保存圖標旁邊找到一個github圖標。使用GitHub集成來構建庫包。您無需安裝本地開發服務器；一切都可以在編輯中發生。

本地服務器設置

此設置為您提供了本地版本的編輯器以及從計算機加載軟件包的能力。這是開發新軟件包的設置。

設定

• 安裝Node.js 8+（您可能需要重新啟動，以便正確應用所有環境變量）
• 克隆https://github.com/microsoft/pxt-arcade to pxt-arcade文件夾。例如，來自git bash

 git clone https://github.com/microsoft/pxt-arcade

• 去pxt-arcade跑步

 cd pxt-arcade
npm install

不要忘記定期git pull和npm install以進行最新更改。

 git pull
npm install

啟動服務器

該命令啟動本地Web服務器。請注意，該Web服務器僅用於開發目的。它不是設計或確保用於在Web服務器上運行的。

 npm run serve

刷新社區.md文件

在必要時運行此命令，然後進行修補描述，改進屏幕截圖（或記錄GIF）。

 pxt ddt featured-game --md docs/community.md

此命令要求將ImageMagick（https://imagemagick.org/index.php）安裝，並在命令行中以“ magick”提供。

更新PXT-Arcade-SIM版本

在更改PXT-Arcade引用的PXT-Arcade-SIM版本時，您需要在三個位置更改該版本：

1. package.json
2. .github/workflows/pxt-buildmain.yml
3. .github/workflows/pxt-buildpush.yml

在兩個YML文件中，您將在檢查PXT-Arcade-SIM的步驟中找到ref字段中的版本。

更新Markdown中的播放列表

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

 pxt downloadplaylists

如何創建精靈包

可以使用PXT軟件包將圖像包添加到編輯器中。創建圖像包。

1. 創建一個軟件包（請參閱上面的步驟）
2. 在噴霧片中準備小精靈：床單中的所有精靈必須相同，並在沒有間隙的網格中排列。 SPRITESHEET必須是PNG文件。一個示例Spritesheet在這裡
3. 在包裝目錄中，創建一個子目錄，將資產放置並複制包含圖像的spriteSheet。
4. 在您創建的目錄中創建一個名為meta.json的文件。可以在此處找到一個示例meta.json
5. 創建另一個.json文件，帶有與SpriteSheet相同的Basename。
6. 在該文件中，添加了一個稱為frames單個屬性，該屬性將其映射到Sprites的名稱數組。索引從紙張的左上角開始，然後從左向右行駛。對於示例文件，請參見此處
7. 從軟件包的根中，運行命令pxt buildsprites SUBDIR其中SUBDIR是包含資產的目錄的名稱。
8. 包根將生成兩個文件，一個文件帶有Extenstion .ts ，一個帶有擴展名.jres 。將兩個添加到包裝的pxt.json
9. 你完成了！將軟件包添加到項目中時，圖像將顯示在圖像類別中

本地開發設置

這些說明使您可以測試對PXT核心和PXT-Common包裝的更改。由於您需要克隆和鏈接3個存儲庫，因此他們更加參與。

• 安裝Node.js 8+（您可能需要重新啟動，以便正確應用所有環境變量）
• （可選）安裝Visual Studio代碼

自動設置

• 下載setup.cmd到您的本地機器，然後將其放在您想完成開發工作的文件夾上
• 運行以下命令

setup.cmd /firsttime

此調用應自動執行手動設置中概述的步驟，並將克隆並鏈接所有三個存儲庫。

手動設置

• 安裝PXT命令行工具

 [sudo] npm install -g pxt

在公共文件夾中，

• 克隆https://github.com/microsoft/pxt到pxt文件夾
• 克隆https://github.com/microsoft/pxt-common packages to pxt-common-packages文件夾
• 克隆https://github.com/microsoft/pxt-arcade to pxt-arcade文件夾
• 去pxt並運行

 npm install
npm run build

• 轉到pxt-common-packages並運行

 npm install
npm link ../pxt

• 去pxt-arcade跑步

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

運行本地服務器

從root github文件夾中，

 cd pxt-arcade
pxt serve --rebundle

https://github.com/microsoft/pxt#Running-a-a-target-from-localhost上的更多說明

注意變化

要在更改時自動重建，我們需要大口。

安裝gulp：

 npm install -g gulp

在距pxt serve和PXT/文件夾中的單獨終端中，運行：

 gulp watch

使用setup.cmd

而不是必須轉到每個存儲庫，而是單獨拉並鏈接每個倉庫，您現在可以使用setup.cmd文件。用法如下概述了以下內容：
/firsttime設置開發人員環境 - 將克隆3個倉庫（PXT，PXT-ARCADE和PXT-COMMON包裝），然後運行 ​​/鏈接選項
/pull對3個存儲庫進行git Pull（PXT，PXT-ARCADE和PXT-COMMON包裝）
/link運行NPM安裝並鏈接3個存儲庫
/run本地服務器並手錶使用GULP進行更改

查看文檔

文檔是在服務器上渲染的，瀏覽器收到時可查看。使用特殊樣式和擴展格式，以防止它們作為廣義降價正確渲染。雖然您可以在存儲庫中瀏覽它們，但它們並不是要像GitHub文檔一樣正確地渲染。

貢獻

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

商標

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