pxt microbit

micro: bit target สำหรับ pxt

PXT-MICROBIT เป็นเป้าหมายการเขียนโปรแกรม Microsoft Programming Toolkit (PXT) เป้าหมายที่ช่วยให้คุณสามารถตั้งโปรแกรม BBC Micro: บิต

• pxt-microbit beta , v3.0.* ต้องการ

  • pxt-microbit#stable33.0
  • PXT#เสถียร 6.0
  • PXT-common-packages#Stable6.0

• pxt-microbit v2.0.* , สาขา stable2.0 , ต้องใช้ PXT v5.15.* มันเป็นสาขาการบริการสำหรับบรรณาธิการสด

• PXT-MICROBIT v1.* ต้องใช้ PXT v4.4 ซึ่งปัจจุบันอยู่ในสาขาที่มั่นคง 4.4 ของ PXT

• pxt-microbit v0.* อยู่ในสาขา V0 ของที่เก็บนี้

• ลองใช้ชีวิต

การติดตามปัญหา

โปรดเพิ่มปัญหาหากคุณค้นพบข้อผิดพลาด (ไม่ได้รายงาน)

การพัฒนาส่วนขยายใหม่

การเขียนและการทดสอบส่วนขยายใหม่สามารถทำได้โดยตรงจากตัวแก้ไขเว็บ ดูเอกสารของเราเกี่ยวกับวิธีการเริ่มต้น หากคุณต้องการเรียกใช้โปรแกรมแก้ไขในพื้นที่ให้อ่านต่อไป

การตั้งค่าเซิร์ฟเวอร์ท้องถิ่น

เซิร์ฟเวอร์ท้องถิ่นให้คุณเรียกใช้โปรแกรมแก้ไขและให้บริการเอกสารจากคอมพิวเตอร์ของคุณเอง มันมีไว้สำหรับนักพัฒนาซอฟต์แวร์คนเดียวที่ใช้และไม่ได้ออกแบบมาเพื่อให้บริการบรรณาธิการแก่ผู้ใช้จำนวนมาก

1. ติดตั้ง node.js 8.9.4 หรือสูงกว่า
2. โคลนที่เก็บนี้

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

3. ติดตั้งบรรทัดคำสั่ง PXT (เพิ่ม sudo สำหรับเชลล์ Mac/Linux)

 npm install -g pxt

4. ติดตั้งการพึ่งพา PXT-MICROBIT

 npm install

ไปที่ส่วน วิ่ง

การตั้งค่านักพัฒนา

นี่คือการตั้งค่าทั่วไปที่ทีม MakeCode ใช้ในการทำงานกับ microbit

1. ติดตั้ง node.js 8.9.4 หรือสูงกว่า
2. ติดตั้ง Docker หากคุณวางแผนที่จะสร้างไฟล์ .cpp
3. โคลนที่เก็บ PXT

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

4. ติดตั้งการอ้างอิงของ PXT และสร้างมัน

 npm install
npm run build
cd ..

5. โคลนพื้นที่เก็บข้อมูล PXT-Packages Packages

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

6. ลิงก์ PXT-common-packages ไปยัง PXT

 npm link ../pxt
cd ..

7. โคลนที่เก็บนี้

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

8. ติดตั้งบรรทัดคำสั่ง PXT (เพิ่ม sudo สำหรับเชลล์ Mac/Linux)

 npm install -g pxt

9. ติดตั้งการพึ่งพา PXT-MICROBIT

 npm install

10. ลิงก์ PXT-MICROBIT กลับไปที่ฐาน PXT repo (เพิ่ม sudo สำหรับเชลล์ Mac/Linux) ขั้นตอนนี้จำเป็นก็ต่อเมื่อคุณตั้งใจจะทำการเปลี่ยนแปลง PXT และ/หรือ PXT-common-packages repos หากสิ่งที่คุณต้องการคือให้บริการ makeCode ในท้องถิ่นคุณสามารถข้ามขั้นตอนนี้ได้

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

หมายเหตุคำสั่งด้านบนถือว่าโครงสร้างโฟลเดอร์ของ

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

วิ่ง

เรียกใช้คำสั่งนี้จาก Inside PXT-MICROBIT เพื่อเปิดเว็บเซิร์ฟเวอร์ท้องถิ่น

 pxt serve

หากเซิร์ฟเวอร์ท้องถิ่นเปิดในเบราว์เซอร์ที่ไม่ถูกต้องตรวจสอบให้แน่ใจว่าได้คัดลอก URL ที่มีโทเค็นท้องถิ่น มิฉะนั้นตัวแก้ไขจะไม่สามารถโหลดโครงการได้

หากคุณต้องการแก้ไขไฟล์ .cpp (และติดตั้ง YOTTA) ให้เปิดใช้งานการรวบรวม YOTTA โดยใช้ --localbuild FLAG:

 pxt serve --local

หากคุณต้องการเพิ่มความเร็วในการสร้างคุณสามารถใช้ตัวเลือก rebundle ซึ่งข้ามอาคารและรีเฟรชข้อมูลเป้าหมาย

 pxt serve --rebundle

การทำความสะอาด

บางครั้งโฟลเดอร์ที่สร้างขึ้นของคุณอาจอยู่ในสภาพที่ไม่ดีทำความสะอาดและลองอีกครั้ง

 pxt clean

อาคารที่มี codal ในพื้นที่

คำสั่งต่อไปนี้บังคับให้บิลด์ท้องถิ่นโดยใช้ codal

 pxt buildtarget --local

เพื่อปิดการใช้งาน Docker ให้เรียกใช้

 export PXT_NODOCKER=1

หากคุณกำลังปรับเปลี่ยนโค้ดให้ลองใช้ pxt clean เพื่อให้แน่ใจว่าสาขาที่เหมาะสมจะถูกหยิบขึ้นมา

การปรับเปลี่ยน dal/codal ในพื้นที่

• ทำตามคำแนะนำด้านบนจนกว่า pxt serve
• Open Editor บน LocalHost และสร้างโครงการ
• 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
• หากคุณกำลังจะแก้ไขไฟล์ .cpp ใน PXT ให้แทนที่ "core": "*" ใน pxt.json ด้วย "core": "file:../../libs/core" ; ในทำนองเดียวกัน "radio": "file:../../libs/radio" และ "microphone": "file:../../libs/microphone"
• คุณสามารถแก้ไข main.ts เพื่อเปลี่ยนด้าน PXT ของโปรแกรม คุณยังสามารถแก้ไขได้จาก LocalHost Editor; โปรดทราบว่า Download ในตัวแก้ไข localhost จะสร้างไบนารีที่แตกต่างจากบรรทัดคำสั่งเนื่องจากมันสร้างในคลาวด์และใช้ codal เวอร์ชันที่ติดแท็ก
• ในโฟลเดอร์ที่เรียกใช้ pxt build - นี่จะเป็น codal codal ที่ไหนสักแห่งภายใต้ built/ (ขึ้นอยู่กับ Build Engine และ Docker)
• อาจมีปัญหาเกี่ยวกับการส่งออกตัวแปรเช่น pxt_force ดังนั้นรวมถึงพวกเขาในคำสั่ง build สามารถช่วยแก้ปัญหา 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
• หากเป้าหมายไม่ได้สร้างให้ลบไฟล์ใน hexcache ที่พบใน pxt-microbit/built/hexcache เพื่อบังคับให้สร้างท้องถิ่น
• hex ที่สร้างขึ้นสามารถพบได้ใน pxt-microbit/projects/<your project name>/built ชื่อ 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

การอัปเดต

ตรวจสอบให้แน่ใจว่าดึงการเปลี่ยนแปลงจาก repos ทั้งหมดเป็นประจำ คำแนะนำเพิ่มเติมอยู่ที่ https://github.com/microsoft/pxt#running-a-target-from-localhost

อัปเดตเพลย์ลิสต์ใน Markdown

ในการเพิ่มเพลย์ลิสต์ใหม่ให้เพิ่มรายการใน /playlists.json และสร้าง markdown ใหม่ (ดูย่อหน้าด้านล่าง) ตอนนี้คุณจะมีไฟล์แกลเลอรี่ Markdown ใหม่ที่แสดงรายการวิดีโอที่คุณสามารถอ้างอิงใน /targetconfig.json

รับคีย์ Google API และเก็บไว้ในตัวแปรสภาพแวดล้อม GOOGLE_API_KEY (เปิดข้อมูลจากแอพ)

 pxt downloadplaylists

repos

เป้าหมาย PXT-microbit ขึ้นอยู่กับ repos อื่น ๆ หลักคือ:

• https://github.com/microsoft/pxt, The PXT Framework
• https://github.com/microsoft/pxt-common-packages, API ทั่วไป accross Editors MakeCode ต่างๆ
• https://github.com/lancaster-university/microbit, wrapper พื้นฐานรอบ ๆ 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/intellectualproperty/trademarks/usage/general.aspx หากการใช้งานไม่ครอบคลุมในแนวทางที่เผยแพร่ของ Microsoft หรือคุณไม่แน่ใจโปรดปรึกษาที่ปรึกษากฎหมายหรือทีม MakeCode ของคุณ ([email protected])