Як перейти з нуля до Create-React-App у Windows

Помітний посібник із налаштування середовища веб-розробки в Windows 10

Я був професійним веб-розробником з березня 2018 року і використовував як MacO, так і Windows у той час. Моєю улюбленою ОС є Windows, я не з інших причин, ніж я віддаю перевагу розкладці клавіатури.

У Windows / Linux мені подобається мати клавішу Ctrl як ключ для операцій копіювання-вставки, і я можу використовувати мій мізинець замість великого пальця. У будь-якому випадку, давайте залишимо слабкі міркування позаду, оскільки це не мета цієї публікації!

Якщо у вас немає машини з Windows, то ця публікація, мабуть, не для вас, якщо це відрізняється від того, що ви використовуєте, це не робить це поганим.

Давайте подивимося, що Кен на це скаже:

Отже, я близько 4 місяців постійно використовую Windows на роботі, і, однак, це зовсім не погано.

- PATAGUCCI MANE (@ken_wheeler) 20 грудня 2018 року

Це оновлення мого посібника з початку року щодо налаштування середовища веб-розробки на машині Windows.

Цей посібник розгляне встановлення Ubuntu, але ви можете використовувати деякі інші варіанти Linux, доступні в магазині Windows, налаштування Debian буде дуже схожим на Ubuntu.

Мета цього допису

Щоб перейти від свіжого екземпляра Windows 10 до чогось, з чим можна розробляти веб-програми.

Ці інструкції стосуються оновлення Windows 10 Fall Creators Update та пізніших версій.

Що ми будемо охоплювати:

  • Встановіть WSL
  • Увімкніть WSL на вашому комп'ютері
  • оновлення, оновлення та автоматичне видалення
  • Встановити вузол (з n)
  • Встановіть Visual Studio Code
  • Встановіть Windows Git
  • Встановлення терміналу (Hyper)
  • Встановіть Fish Shell!
  • Встановіть Oh My Fish
  • Рибні теми з OMF
  • Налаштуйте
  • Git config
  • Створіть додаток React
  • Використовуйте SSH з GitHub
  • Конфігурація WSL SSH
  • Windows Git Bash SSH Config
  • Змінити версію WSL
  • Загорніть!

Встановіть WSL

Ви можете встановити Ubuntu з магазину Microsoft, який буде першою половиною інсталяції, другою буде, коли ви відкриєте програму.

Увімкніть WSL на вашому комп'ютері

Офіційні вказівки це дуже добре висвітлюють, але я збираюся додати тут комбінації клавіш, якщо ви не хочете натискати мишкою.

Однак до цього, якщо ви не вибрали PowerShell в якості командного рядка за замовчуванням, ви можете вибрати його на сторінці налаштувань панелі завдань, розташованій у розділі Персоналізація в налаштуваннях, я пропоную зробити це зараз:

Поки ми це робимо, нам також слід увімкнути приховані папки та додати розширення файлів для відомих типів файлів у Провідник файлів Windows.

Відкрийте Провідник файлів Windows за допомогою клавіші Windows + e, а потім виберіть Переглянути на стрічці. Потім натисніть кнопку Параметри вкрай праворуч, відкриється діалогове вікно Параметри папки, звідки ми хочемо вибрати вкладку Перегляд і вибрати перемикач для прихованих файлів і папок із пунктом "Показати приховані файли, папки та диски", також зніміть прапорець біля пункту "Сховати розширення для відомих типів файлів". Натисніть Застосувати та Добре.

Причина, по якій ми робимо це, полягає в тому, що ми можемо бачити .gitпапку в структурах проектів, вона також потрібна для таких .envфайлів, як файли, які використовуються для конфігурації середовища.

Використовуйте клавішу Windows + x, це те саме, що клацнути правою кнопкою миші піктограму Windows на робочому столі, відкриється меню швидкого посилання. Звідси вам потрібно вибрати опцію Windows PowerShell (Admin), це можна зробити, натиснувши клавішу a на клавіатурі. Тож клавіша Windows + x потім a, відкриє запит керування обліковим записом користувача (Адміністратор), припускаючи, що у вас є права адміністратора на вашому комп'ютері, вам потрібно натиснути так, щоб продовжити.

Скопіюйте код сюди та вставте його у вікно PowerShell, Ctrl + v працюватиме в PowerShell, натисніть Enter, щоб виконати команду.

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux

Після цього вам буде запропоновано перезапустити машину, що вам слід зробити.

Перевірте посилання, щоб отримати повний список комбінацій клавіш для Windows.

Після перезапуску ви можете відкрити програму Ubuntu з меню «Пуск», і має відбутися друга інсталяція (WSL у вашій системі). Зачекайте, поки це завершиться, тоді вам буде запропоновано створити користувача та пароль для облікового запису. Вам потрібно буде пам’ятати пароль, створений для користувача, оскільки вам буде запропоновано використовувати sudoпривілеї.

оновлення, оновлення та автоматичне видалення

На момент написання цього повідомлення, версія, яку я зв’язав з Ubuntu, - це 18.04.1

Пов’язана програма встановить останній стабільний випуск Ubuntu для Windows.

Ви можете перевірити, яку версію Ubuntu ви встановили:

lsb_release -a

Якщо ви хочете використовувати певну LTS-версію Ubuntu, ви можете отримати їх із магазину Windows тут:

  • Ubuntu 16.04 LTS
  • Ubuntu 18.04 LTS

Тепер ми продовжимо оновлення та оновлення всіх речей, три команди тут оновлять та оновлять все попередньо встановлене програмне забезпечення, яке постачається з установкою Ubuntu.

Код нижче - це три команди, об’єднані разом з &&. -yПрапор для автоматичного прийняття змін , які будуть виконуватися з модернізаціями. Автоматичне видалення видалить невикористані пакунки, що залишились, з оновлень.

Скопіюйте наведені нижче команди у ваш термінал Ubuntu і запустіть команду:

sudo apt update && sudo apt -y upgrade && sudo apt autoremove
Щоб перейти з 16.04 до 18.04, спробуйте do-release-upgradeв терміналі. будьте застережені, це займає значно більше часу, ніж просто видалення поточної інсталяції Ubuntu і початок заново.

Тепер, коли база була встановлена ​​та оновлена, нам потрібно встановити пакет, необхідний для побудови, для компіляції та побудови інших пакунків, і всі наступні пакети, які ми збираємось встановити, будуть потрібні.

sudo apt install -y build-essential

Відтепер я пропоную використовувати два вікна bash, одне з включеним sudo, інше зі стандартними дозволами.

тобто відкрити термінал і не входити sudoтуди, замість цього використовувати термінал, якому надано такий дозвіл.

Причиною цього є те, що я знайшов, якщо ви встановлюєте вузол як sudo, тоді кожного разу, коли ви хочете запустити npm installкоманду, вам потрібно буде надати дозволи sudo, і все це може стати трохи нудним. І ви дійсно не повинні встановлювати пакунки npm з дозволами sudo.

Встановити вузол (з n)

Let’s get our run-time on! If you use Node.js you will eventually have situations where you need to be able to switch Node versions, for this you may have heard to nvm (Node Version Manager) which by the way you can still use in WSL.

The reason for me opting for n over nvm is that in the past I experienced slow bash startup times whilst using nvm. Take a look at this WSL GitHub issue detailing it and the specific comment for the pros of using n.

Ok let’s install n, with n-install, the command doesn’t start with sudo so use it in the bash window you have with no sudo privileges.?

curl -L //git.io/n-install | bash

This will install the latest version of Node for us, follow the prompt on the terminal screen to reload bash:

# mine looks like this. /home/scott/.bashrc

Now check the versions of Node and npm we have installed with node -v && npm -v in the terminal.

Install Visual Studio Code

Install VSCode? What? This post is to set up WSL? Ok, so we’re going to presume that this is going from nothing to being able to web dev, so we’re going to need a text editor, and there’s nothing out there at the moment that comes close to VSCode, if you already have a text editor installed then skip to the next part.

Install the Windows version of VSCode from the Download section once installed we can enable WSL in the settings, the quickest way to do this is to open the integrated terminal in VSCode with the shortcut keys Ctrl+’ ? that’s and apostrophe. You will be prompted to select your default terminal, select WSL Bash.

Install Windows Git

There’s a bit of stumbling block getting Git support for VSCode, it’s well documented in the various issues mentioned in the linked issue.

There are workarounds as well with things like WSLGit which has its own set of issues, this all stems from users (me included) not wanting to have to install another binary for Git.

I have tried several variants when it comes to using Git with VSCode and the path of least resistance was biting the bullet and installing that additional binary, there’s an overhead with having to maintain and configure SSH keys for both Windows and WSL Git but it’s a one time setup.

Until the VSCode team incorporate WSLGit into VSCode I think this is the best option.

Install from git-scm.com the link will start downloading the install binary you can then open it and go through the install, you can keep clicking next through the install, I have selected a few options that I would like enabled.

For now, that is all we need to do, when it comes to authenticating with with GitHub using SSH we will use the Git Bash command line to configure the Windows side of things.

Install a Terminal (Hyper)

Now we have bash on Windows it’s time to install a nice Terminal app, because, let’s face it, the standard one is a bit basic.

Enter Hyper an electron based terminal app that is super themeable and configurable.

Download and install hyper for Windows, this will be the bare-bones version, it’ll look something like this:

You may notice that, this is the Windows Command prompt too — don’t worry, we’re going to configure that right now.

Open up the .hyper.js file located in the root of your user folder, or from Hyper itself use the shortcut key Ctrl+, to pop open the settings.

If the settings file (.hyper.js) opens in Notepad then you can set the default to be VSCode. In File Explorer (Use Windows key+e to open it) navigate to the file, it'll be in your User folder, right-click the file and select Properties, then Change for 'Opens with:' and select VSCode from the list.

Now we can set WSL as the shell path in Hyper, open the .hyper.jssettings file and search (Ctrl+f) for bash, we want to add the path to the WSL shell into the shell property defined in the file.

// amend shell path// WSL Bashshell: 'C:\\Windows\\System32\\bash.exe',

We can also change the appearance of Hyper from here by specifying font size and font family and also predefined themes, let’s quickly add in the hyper-adventure-time theme into the plugins section.

Open another Hyper tab with Ctrl+Shift+t, this will show the bash terminal for WSL now.

Quick orientation with the Hyper terminal keyboard shortcuts:

  • New tab = Ctrl+Shift+t
  • Close current tab = Ctrl+Shift+w
  • Cycle through tabs right = Ctrl+Shift+right arrow
  • Cycle through tabs left = Ctrl+Shift+left arrow

Now I’m going to configure some additional properties for Hyper, and change the theme to something a bit more subtle.

I purchased Dank Mono, if you want a similar font as OSS check out FiraCode.

Here’s what I changed:

module.exports = { config: { fontSize: 18, fontFamily: '"Dank Mono",...', cursorShape: 'BEAM', cursorBlink: true, copyOnSelect: true, plugins: ['hyper-altair'] }}

Install Fish Shell!

Ok, time to install the Fish Shell! This is a completely optional step, I like to use fish for the nice intellisense you get when navigating file structures, there are also some neat themes you can get with Oh My Fish

sudo apt -y install fish

Install Oh My Fish

Now we can install Oh My Fish (OMF) and get a nice terminal theme going on too, remember we talked about running commands with the correct permissions? Well this is one of those occasions, open a new tab first then paste in the following:

curl -L //get.oh-my.fish | fish

Fish themes with OMF

After installing OMF you can pick a theme, here you may notice that the text doesn’t fit in the screen on Hyper, a quick way to reset it is to maximise the window then back again, I did this with the Windows key+arrow up to maximise the Windows key+arrow down to restore it.

After installing omf I chose the theme agnoster, installed with omf install agnoster you can list out what is available and what you have already installed by selecting omf theme let's change it once more to the one theme, adjust the size of the window first as things are getting a bit cramped.

Have a play around there’s loads there, I prefer the one theme because you can see what version of node you’re running on, over on the far right. Here you can also see the intellisense for fish where it shows agnoster as a previous selection, if I wanted to select agnoster I could tab to complete the rest of the command.

Configure

So, now we have a swanky looking new terminal and a bare-bones VSCode install it’s time to get things moving.

I have a cheat-sheets repo detailing a lot of the configuration we’re about to go through here, if you find something useful along the way please drop a PR with the suggestion.

First up, in place of typing out fish each time I open a new terminal, and not replacing bash which you can do, but I prefer to use an alias. So what we're going to do is open up the .bashrc file and edit it.

From a new terminal type in nano ~/.bashrc, nano is a bash text editor. Scroll (or Page) down to the bottom of the file and add in an alias for fish, alias f=fish then to exit nano Ctrl+x and confirm changes with a y. Reload the .bashrc file like we did after using n to install Node . /home/scott/.bashrc but your username in place of mine ?, now we can use f instead of fish! Well done you saved yourself typing three extra characters!!!

Git config

Before we crack on with spinning up a Create React App instance we’re going to need to configure Git, via the .gitconfig file.

We’re going to use nano to add some settings for Git, both in WSL and Windows, this is the extra config I mentioned earlier, apologies!

First up we’ll config our bash environment and then move onto Git bash on Windows.

# open up the .gitconfig file in WSL bash# nano will create one if it doesn't existnano ~/.gitconfig

It’s nearly identical config for both environments apart from Windows uses the credential manager helper and WSL will need the cache helper.

# needed in Git Bash for Windows[credential] helper = manager# needed in WSL[credential] helper = cache[color] ui = true
[user] name = yourGitHubUserName email = [email protected]
[core] editor = code --wait

Make your changes then Ctrl+x to exit and confirm with y, that’s the first part of the Git config done.

In Git Bash for Windows do the same in the terminal, use nano to create a .gitconfig file and add the setting to it.

Create React App

Ok, we shall get create react app going so we can get Git configured with GitHub using SSH and start making changes to commit to a GitHub repo.

We’re going to use npx to make a starter React project with Create React App. If you want to have your projects somewhere else now is the time to navigate to that directory.

From the terminal enter:

# this will create a starter react project# called create-react-appnpx create-react-app create-react-app

This is creating the project in my home (~) folder, I've had to speed the gif up to 20x faster, it does take a while.?

Wheeeeeeeeeeeeeeeeeeeee!

So, now that we have spun up a React app to work on we should make a change and then add it to GitHub.

Navigate to the create-react-app folder in the terminal and open the project. You can open VSCode with the code . command, the . denotes the current folder in the terminal.

This will open VSCode at the root of the create-react-app project, make sure everything is working as expected by running the start script in npm.

npm run start

If you want to see what scripts are available in the current project you can also use npm run which will list defined npm commands from the package.json file.

Відкриється вікно, що відображає основну цільову сторінку Create React App, ми збираємося додати h1 до App.jsмодуля, а потім зафіксувати його через меню Source Source у VSCode.

Будь ласка, майте на увазі, що це запущений посібник для середовища для розробки, я не буду детально описувати розробку в React

Поки термінал зайнятий запуском сторінки create-response-сторінку, ми можемо відкрити ще одну вкладку в Hyper за допомогою Ctrl + Shift + t і відкрити VSCode за допомогою code .команди, перейти до App.jsкомпонента та додати <до нього тег h1> просто above thet; тег з

; Привіт Реагуй!

в цьому.

Now the landing page should show the newly added h1, we can confirm that the file is changed in Git by doing a git status from the terminal. Then we can commit it from either the terminal or the IDE (VSCode) my preference is to use VSCode as the visual diffing of files is great.

Commit the changes with Ctrl+Enter if you have not selected the file you want to commit you will get a dialogue telling you there are no staged changes to commit, you can select the files (in this case only the App.jsfile) by clicking the plus next to the file. Hitting Ctrl+Enter again will commit the changes with a message, you can check that there are no changes to commit with git status from the terminal or visually from the Source Control section in VSCode.

Ok, time to add our super sweet code changes to a repository on GitHub for the world to see!

Next up we’re going to go through adding the local changes we’ve made to a GitHub repository. If you haven’t got a GitHub account and are following along now may be a good time to set one up.

Use SSH with GitHub

First up, we’re going to make a repository on GitHub and push the changes we have made to it, here we’re going to click the + button in the top right of the GitHub home page, enter a repository name and GitHub will give you some defaults to choose from. As we have already made change locally we can ignore the first several commands but we do need the command to add the remote:

git remote add origin [email protected]:spences10/cra.git

And to push the changes up to GitHub git push -u origin master but we're going to get an error, as we haven't set up SSH.

WSL SSH Config

Відкрийте нову вкладку bash в Hyper і введіть, ls -al ~/.sshперевірте, чи немає rsaфайлів, перш ніж це робити.

Ви помітите, що ми робимо це в bash, а не в Fish.

Якщо там нічого немає, тоді генеруйте нові ключі за допомогою:

# add your email address ?ssh-keygen -t rsa -b 4096 -C [email protected] 

Тепер ls -al ~/.sshбуде показано два додаткові файли:

# there should be a private and public key-pairid_rsaid_rsa.pub

Запустіть агент SSH:

eval "$(ssh-agent -s)"

Додайте ключ RSA до SSH за допомогою:

ssh-add ~/.ssh/id_rsa

Тепер час додати відкритий ключ SSH до GitHub, у WSL ми збираємося скопіювати пасту відкритого ключа SSH cat ~/.ssh/id_rsa.pubу Hyper. Тоді ми можемо скопіювати з Hyper на новий ключ SSH.

Нарешті, автентифікуйтесь за допомогою GitHub:

ssh -T [email protected]

Windows Git Bash SSH Config

Для Windows Git Bash ми збираємося скопіювати наші SSH-ключі, які ми щойно створили в WSL, у Windows Git Bash, є деякі незначні відмінності при автентифікації за допомогою Windows Git Bash.

З Hyper скопіюйте файли SSH з Linux в Windows:

cp ~/.ssh/* /c/Users/spenc/.ssh/

Запустіть агент SSH:

eval `ssh-agent -s`

Додайте ключ до агента SSH:

ssh-add ~/.ssh/id_rsa

Аутентифікація:

ssh -T [email protected]

Now the additional set up for SSH is done we should be able to go back to Hyper and push our change to GitHub.

Also, you may have noticed that the SSH Key ? token went from black to green on the settings screen there this indicates that you have authenticated.

Change WSL version

If you want to use a different version of Ubuntu, Debian or any of the other available distributions of Linux from the Windows store with Hyper you will need to change the default version from PowerShell:

# list available versionswslconfig /l# set defaultwslconfig /setdefault Debian

Wrap up!

That’s it! We have gone from scratch to a functioning web development environment. There are several other personal things I’m now going to add to my install now which is aliases for both Git and Fish shell. If you are interested in them I have a cheat-sheet for Fish with a list of all my aliases I use, the same for my .gitconfig you can find that in my dotfiles repo

Thanks for reading ?

This was originally posted on my Gatsby blog you can view it here please take a look at my other content if you enjoyed this.

Follow me on Twitter or Ask Me Anything on GitHub.

You can read other articles like this on my blog.