Microsoft MakeCode основан на открытом проекте Microsoft Programming Experience Toolkit (PXT). Microsoft MakeCode
— это имя, используемое в пользовательских редакторах, PXT
используется во всех исходных кодах на GitHub.
PXT — это фреймворк для создания специализированных программных сред для начинающих, особенно ориентированный на образование в области информатики. Основной язык программирования PXT — это подмножество TypeScript (с исключением динамических возможностей JavaScript).
Основные возможности PXT:
Дополнительная информация:
Примеры редакторов, построенных с помощью MakeCode:
master
— это активная ветка разработки, в настоящее время используется v3.*
сборкиv*
— это ветка обслуживания для v*.*
сборок## Запуск целевой системы с локального сервераПожалуйста, следуйте инструкциям здесь.
Если вы изменяете свою собственную версию PXT и хотите, чтобы целевая система (например, pxt-microbit) использовала вашу локальную версию, перейдите в директорию целевой системы (например, pxt-microbit, которая должна быть сестринской директорией pxt) и выполните
pxt link ../pxt
Если у вас есть несколько версий pxt, вы можете сделать следующее:
npm i
в pxt и целевой системеpxt link ..\some-other-pxt
(может потребоваться обновление вашей CLI, выполните npm install -g pxt
)Если вы выполните npm i
после этого (в целевой системе или pxt), вам может потребоваться повторить эти шаги.
Сначала установите Node: минимальная версия 8. Для сборки командных строковых инструментов PXT:
npm install
npm run build
Затем установите командный строковый инструмент pxt
(необходимо выполнить только один раз):
npm install -g pxt
Затем установите gulp
(необходимо выполнить только один раз):
npm install -g gulp
После этого вы сможете запустить pxt
из любой точки дерева сборки.
Чтобы запустить локальный веб-сервер, выполните pxt serve
из корневой директории целевого приложения (например, pxt-microbit). PXT откроет редактор в вашем по умолчанию веб-браузере.Если вы разрабатываете для pxt, вы можете запустить gulp watch
из корневой директории репозитория pxt для отслеживания изменений и пересборки.
gulp watch
Если вы работаете исключительно над CLI,
gulp watchCli
Если вам не нужно собирать набор связанных веб-приложений (skillmap, многопользовательский режим и т.д.), вы можете пропустить их и немного ускорить сборку:
gulp --no-webapps
В директории svgicons/
находятся несколько пользовательских иконок (для использования в дополнение к http://semantic-ui.com/elements/icon.html). Эти иконки должны быть размером 1000x1000px
. Лучше всего начать с существующей иконки. Чтобы просмотреть доступные иконки, перейдите на http://localhost:3232/icons.html (этот файл, а также icons.css
, содержащий сгенерированный WOFF шрифт иконок, создается во время сборки).
Если у вас возникли проблемы с отображением созданной иконки, попробуйте:
npm install -g svgo
svgo svgicons/myicon.svg
Когда вы добавляете CSS-цвет или другой элемент стиля, который будет использоваться в редакторах целевых приложений (например, micro:bit, Arcade) и под-приложениях (например, skillmap, teachertool и т.д.), объявите переменную CSS для него в theme/themepacks.less
:1. Добавьте новую переменную в псевдокласс :root
. Выберите разумное значение по умолчанию в соответствии с рекомендациями в файле.
2. Добавьте новую переменную во все темы, определенные в этом файле. На момент написания этого текста определена только тема theme-highcontrast
. Выберите значение, которое хорошо работает для данной темы.
3. Добавьте новую переменную в темы для каждого целевого приложения. Это будет выполнено в файле theme/themepacks.less
целевого репозитория (например, pxt-microbit, pxt-arcade).Переменные, объявленные таким образом, будут доступны для под-приложений во время выполнения, и они будут инициализированы значениями, определенными целевым приложением, в котором они выполняются.### Выделение кода в документации
В документации выделение фрагментов кода осуществляется с помощью highlight.js (hljs). В настоящее время включены следующие языки:
Если вам необходимо добавить другие языки или обновить существующие, вы можете найти распределение по адресу https://highlightjs.org/download/;
выберите все языки, которые вы хотите включить (включая указанные выше!),
скачайте и распакуйте,
а затем скопируйте highlight.pack.js
в webapp/public/highlight.js/
.
Тесты расположены в подпапке tests/
и представляют собой комбинацию тестов на уровне модуля и браузерных тестов. Для их выполнения запустите npm run test:all
в корневой директории.
Этот проект использует Microsoft Open Source Code of Conduct. Для получения дополнительной информации обратитесь к FAQ по Коду поведения или свяжитесь с opencode@microsoft.com с любыми дополнительными вопросами или комментариями.
Свяжитесь с нами## Торговые марки
MICROSOFT, логотип Microsoft и MAKECODE являются зарегистрированными товарными знаками корпорации Microsoft. Они могут использоваться только в соответствии с целями, описанными в и в соответствии с правилами использования товарных знаков и бренда Microsoft, опубликованными по адресу https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general.aspx. Если использование не описано в опубликованных правилах Microsoft или вы не уверены, обратитесь к вашему юридическому консультанту или команде MakeCode (makecode@microsoft.com).
Вы можете оставить комментарий после Вход в систему
Неприемлемый контент может быть отображен здесь и не будет показан на странице. Вы можете проверить и изменить его с помощью соответствующей функции редактирования.
Если вы подтверждаете, что содержание не содержит непристойной лексики/перенаправления на рекламу/насилия/вульгарной порнографии/нарушений/пиратства/ложного/незначительного или незаконного контента, связанного с национальными законами и предписаниями, вы можете нажать «Отправить» для подачи апелляции, и мы обработаем ее как можно скорее.
Комментарии ( 0 )