Я хочу установить программное обеспечение из GitHub на мою Ma c. Проблема в том, что инструкции, предоставленные разработчиком, крайне минимальны. Либо так, либо я слишком большой нуб в командной строке и управлении пакетами.
Это страница GitHub: https://github.com/sehugg/8bitworkshop
( Предыстория: это IDE для создания 8-битных игр для NES, Atari и др. c., Которая запускает в браузере . Но я хочу управлять несколькими проектами в разных папках, и это не будет возможно, если я не смогу запустить его локально на моем компьютере.)
Предоставляются следующие инструкции ...
Установка
Для создания IDE 8bitworkshop:
git submodule init
git submodule update
npm i
npm run build
Использование
Запустить веб-сервер на http://localhost: 8000 / , пока TypeScript компилируется в фоновом режиме:
make tsweb
Выполнить Тесты
npm test
На этом завершаются инструкции. Теперь о вещах, которые я ищу прояснения о ...
Часть 1 - Git
У меня установлено Git. Я знаю это, потому что, когда я набираю git --version, я вижу git version 2.20.1 (Apple Git-117) Но , очевидно, эта версия старая и, вероятно, поставляется с инструментами командной строки. Так должен ли я (A) удалить эту версию и установить последнюю? (B) Попытаться обновить эту версию до последней? (C) Оставьте это в покое, потому что мне не нужна последняя версия? (И какой лучший способ сделать, какой из этих параметров рекомендуется?)
Что делают команды субмодуля? ( Выглядит сложно. ) Мне вообще нужно знать или мне просто нужно их набирать?
Часть 2 - NPM
У меня нет NPM установлен, и я очень мало знаю об этом. Все поисковые запросы NPM также включаются Node.js. Хотя я не думаю, что мне нужно Node.js (?), Если установка Node.js также дает мне NPM (как показывает это видео ), я сделаю это.
После установки NPM я думаю, мне нужно cd в распакованную папку 8bitworkshop-master, а затем набрать npm i и npm run build.
Часть 3 - TypeScript & Настройка веб-сервера
Впервые слышу о TypeScript. Google говорит мне, что это "строгий синтаксический расширенный набор JavaScript". Наверное, мне следует сделать make tsweb в папке 8bitworkshop-master?
Существуют различные способы настройки веб-сервера на macOS.
Один из них - SimpleHTTPServer .
Еще один способ - отредактировать httpd.conf, как показано в этом видео .
И еще есть Xampp , который я ' Я использовал ранее, но я не уверен, что будет работать в этом конкретном случае.
Если кто-нибудь может посоветовать лучший способ настроить веб-сервер для запуска этой IDE, я буду благодарен.
Часть 4 - Тест
Значит я наберу npm test и что-нибудь случится? Что я буду тестировать? Не совсем уверен. Я предполагаю, что будет какая-то обратная связь, сообщающая мне, что я преуспел или потерпел неудачу.
Если вы прочитали это далеко, спасибо. Причина, по которой я спрашиваю об этих шагах, заключается в том, что я хочу получить как можно больше знаний, прежде чем пытаться вместо того, чтобы просто промахиваться. Были случаи, когда я заканчивал тем, что установил несколько версий языков программирования в разных местах, или почти дошел до конца процесса установки, только чтобы произошла какая-то ошибка, оставив кучу файлов, скопированных в who-знает-где. И решить такие проблемы еще сложнее, чем начать установку. Так что любая помощь приветствуется.