MakeCode für den Calliope
Go to file
Galen Nickel d0a1078b93
Fix link format for offline-app page ()
* fix link format for offline-app page

* Add pre-release note/hint
2019-02-22 16:22:27 -08:00
.github/ISSUE_TEMPLATE Update issue template for microbit 2018-05-17 16:20:14 -07:00
.vscode fixing getting started 2017-04-28 17:26:19 -07:00
clients removed chrome extension code 2018-10-01 19:31:35 -07:00
docs Fix link format for offline-app page () 2019-02-22 16:22:27 -08:00
editor Support latest PXT with GC () 2019-02-21 15:41:32 -08:00
electron Release Electron app v0.9.15 2017-03-07 10:19:10 -08:00
external Add serial support over webusb () 2018-07-27 13:28:58 -07:00
fieldeditors Add field gesture and field images for the different gestures () 2018-05-24 17:09:08 -07:00
libs Support latest PXT with GC () 2019-02-21 15:41:32 -08:00
pxtwapp super basic trouble shooting page for windows app () 2017-12-04 22:26:25 -08:00
resources Update hero banner with latest () 2018-11-09 13:26:16 -08:00
sim Support latest PXT with GC () 2019-02-21 15:41:32 -08:00
tests Update tests. remove converted test for the time being 2018-04-21 10:45:02 -07:00
theme Remove search bar on mobile () 2018-11-09 13:26:06 -08:00
.clang-format Implement tagged integers in C++ () 2018-05-29 15:55:58 -07:00
.gitattributes Add own manifest 2016-04-08 17:28:52 -07:00
.gitignore updated language list 2018-03-12 11:24:11 -07:00
.travis.yml Adding blocks tests () 2018-11-14 12:54:26 -08:00
CONTRIBUTING.md Updating with the MIT license text and contributing guideline 2016-11-28 17:11:45 -08:00
faviconDescription.json adding favicon configuration file 2016-10-20 11:09:34 -07:00
LICENSE.txt Updating with the MIT license text and contributing guideline 2016-11-28 17:11:45 -08:00
package-lock.json 1.2.19 2019-02-21 15:44:39 -08:00
package.json 1.2.19 2019-02-21 15:44:39 -08:00
ptrcheck-ignore update ignore file 2016-07-14 12:04:06 -07:00
pxtarget.json Support latest PXT with GC () 2019-02-21 15:41:32 -08:00
README.md Modify readme info () 2018-12-09 11:07:37 -08:00
targetconfig.json add iKb-1 board () 2019-02-15 10:54:50 -08:00
THIRD-PARTY-NOTICES.txt enfore v0 sounds () 2018-09-13 11:03:46 -07:00
travis-tests.sh Remove 3 converter tests with overflowing numbers 2016-10-04 08:20:30 -07:00
tslint.json fixing various lint violations 2016-05-04 23:31:55 -07:00
webmanifest.json Updating all pxt.microbit.org reference to makecode.microbit.org () 2017-07-24 13:39:27 -07:00

micro:bit target for PXT

Build Status

pxt-microbit is a Microsoft Programming Experience Toolkit (PXT) target that allows you to program a BBC micro:bit.

Issue tracking

Please add an issue if you discover an (unreported) bug.

Developing new extensions

Authoring and testing of new extensions can be done directly from the web editor. See our documentation on how to get started. If you want to run the editor locally, keep reading.

Local server

The local server lets you to run the editor and serve the documentation from your own computer. It is meant for a single developer used and not designed to serve the editor to a large amount of users.

Developer Setup

This is the typical setup used by the MakeCode team to work on the microbit.

  1. Install Node.js 8.9.4 or higher.
  2. Install Docker if you plan to build .cpp files.
  3. Clone the pxt repository.
git clone https://github.com/microsoft/pxt
cd pxt
  1. Install the dependencies of pxt and build it
npm install
npm run build
cd ..
  1. Clone the pxt-common-packages repository
git clone https://github.com/microsoft/pxt-common-packages
cd pxt-common-packages
npm install
cd ..
  1. Clone this repository.
git clone https://github.com/microsoft/pxt-microbit
cd pxt-microbit
  1. Install the PXT command line (add sudo for Mac/Linux shells).
npm install -g pxt
  1. Install the pxt-microbit dependencies.
npm install
  1. Link pxt-microbit back to base pxt repo (add sudo for Mac/Linux shells). This step is only required if you intend to make changes to pxt and/or pxt-common-packages repos. If all you want is serve a local Makecode, you can skip this step.
npm link ../pxt
npm link ../pxt-common-packages

Note the above command assumes the folder structure of

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

Running

Run this command from inside pxt-microbit to open a local web server

pxt serve

If the local server opens in the wrong browser, make sure to copy the URL containing the local token. Otherwise, the editor will not be able to load the projects.

If you need to modify the .cpp files (and have installed yotta), enable yotta compilation using the --localbuild flag:

pxt serve --local

If you want to speed up the build, you can use the rebundle option, which skips building and simply refreshes the target information

pxt serve --rebundle

Cleaning

Sometimes, your built folder might be in a bad state, clean it and try again.

pxt clean

Updates

Make sure to pull changes from all repos regularly. More instructions are at https://github.com/Microsoft/pxt#running-a-target-from-localhost

Repos

The pxt-microbit target depends on several other repos. The main ones are:

History

See the MakeCode blog.

Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.