Как запустить приложение angular через node js
Пришло время взглянуть на фреймворк от Google — Angular, еще один популярный вариант, с которым вы часто будете сталкиваться. В этой статье мы рассмотрим, что Angular может предложить, установим необходимые компоненты, запустим пример приложения, и разберём базовую архитектуру Angular.
| Необходимые условия: | Понимание основ HTML, CSS, и JavaScript, знание терминала/командной строки. |
|---|---|
| Цель: | Настроить локальную среду разработки Angular, создать стартовое приложение, и понять основные принципы работы. |
Что такое Angular?
Angular — это платформа для разработки, написанная на TypeScript. Как платформа Angular включает:
- Основанный на компонентах фреймворк для создания масштабируемых веб-приложений
- Набор хорошо интегрированных библиотек, охватывающих широкий спектр функций: маршрутизация, управление формами, клиент-серверное взаимодействие и т.д.
- Набор инструментов разработчика, которые помогут вам разрабатывать, собирать, тестировать и обновлять ваш код
Когда вы создаете приложение с помощью Angular, вы пользуетесь преимуществами платформы, которая может масштабироваться от проекта, который разрабатывает один человек, до приложений корпоративного уровня. Angular разработан, чтобы максимально упростить обновление, поэтому вы можете использовать последние разработки с минимумом усилий. А самое замечательное то, что экосистема Angular состоит из огромного сообщества, включающего более чем 1.7 миллиона разработчиков, авторов библиотек и создателей контента.
Прежде, чем приступить к изучению платформы Angular, сначала стоит познакомиться с Angular CLI. Angular CLI - это быстрый, простой и рекомендуемый способ разработки Angular-приложений. Angular CLI облегчает выполнение ряда задач. Вот некоторые из них:
| ng build | Компилирует Angular-приложение в выходной каталог. |
| ng serve | Собирает и запускает ваше приложение, пересобирая его при изменении файлов. |
| ng generate | Генерирует или изменяет файлы на основе схематиков |
| ng test | Запускает модульные тесты для заданного проекта. |
| ng e2e | Собирает и запускает Angular-приложение, запуская затем сквозные тесты. |
Скоро вы сами убедитесь, что Angular CLI является полезным инструментом для создания ваших приложений.
Что вы создадите
Эта серия руководств проведёт вас через создание приложения со списком дел (to-do list). С помощью этого приложения вы узнаете, как использовать Angular для управления, редактирования, добавления, удаления и фильтрации элементов.
Необходимые условия
Чтобы установить Angular в вашей локальной системе, вам понадобится следующее:
Node.js
Angular требует текущую, последнюю LTS, или поддерживаемую LTS версию Node.js. Для получения информации о конкретных требованиях к версии смотрите ключ engines в package.json файле.
пакетный менеджер npm
Angular, Angular CLI, Angular приложения зависят от npm пакетов которые обеспечивают множество функций. Для загрузки и установки npm пакетов, вам необходим пакетный менеджер npm. Это руководство использует npm через интерфейс командной строки, который устанавливается с Node.js по умолчанию. Для того, чтобы узнать какая версия npm установлена, запустите npm -v в терминале.
Настройка приложения
Вы можете использовать Angular CLI, запуская команды в терминале для генерации, сборки, тестирования, и развертывания приложений на Angular. Для установки Angular CLI, запустите следующие команды в терминале:
Команды Angular CLI начинаются с ng , за которым следует то, что вы хотите CLI сделал. В рабочей директории (например, Desktop) выполните команду ng new , чтобы создать новое приложение под названием todo :
В текущей директории команда ng new создаст необходимое для работы маленькое Angular-приложение. Дополнительные флаги, --routing и --style , определяют, как обрабатывать навигацию и стили в приложении. В этом руководстве эти функции будут описаны позже.
Если вам будет предложено применить строгую проверку типов, вы можете ответить "yes".
Перейдите в ваш новый проект с помощью команды cd :
Запустите ваше приложение todo , выполнив команду ng serve :
Когда CLI спросить про аналитику, ответьте no .
Пока выполняется ng serve , запускать другие команды можно в новой вкладке или окне терминала. Если вы захотите остановить работу приложения, нажмите Ctrl+c в терминале, где оно было запущено.
Знакомство с вашим Angular приложением
Исходные файлы, на которых будет сосредоточено внимание в этом руководстве находится в src/app . Файлы, генерируемые CLI автоматически, на которые стоит обратить внимание:
Таким образом, с самого начала вы используете лучшие приёмы разработки.
Каждый раз, когда вы генерируете компонент, CLI создает эти четыре файла в каталоге с указанным вами именем.
Структура Angular приложения
Angular построен на TypeScript. TypeScript — это надмножество JavaScript, т.е. любой правильный JavaScript-код будет работать в TypeScript. TypeScript предлагает типизацию и более лаконичный синтаксис, чем простой JavaScript, который дает вам инструмент для создание более удобного в сопровождении кода и минимизации ошибок.
Компоненты — это строительные блоки Angular-приложений. Компоненты включают TypeScript-класс, который имеет декоратор @Component() , HTML-шаблон и стили.
Класс
Компонент называется ItemComponent , и имеет селектор app-item . Вы можете использовать этот селектор как и обычные HTML-теги, помещая его в другие шаблоны. Когда селектор находится в компоненте, браузер отображает шаблон этого компонента. Это руководство поможет вам создать два компонента и использовать один в другом.
Компонентная модель Angular предлагает надежную инкапсуляцию и интуитивно понятную структуру приложения. Компоненты также упрощают модульное тестирование вашего приложения и могут улучшить общую читаемость кода.
HTML-шаблоны
У каждого компонента есть HTML-шаблон, в котором определяется то, что этот компонент будет отображать. Шаблон можно задать либо строкой, либо как путь к файлу.
Для ссылки на внешний HTML-файл, используется свойство templateUrl :
Чтобы указать напрямую HTML-код, используется свойство template с обратными кавычками:
Angular расширяет HTML дополнительным синтаксисом, который позволяет вставлять динамические данные в компонент. Angular автоматически обновляет DOM, когда состояние компонента изменяется. Например, этот синтаксис можно применить для вставки динамического текста, как показано в следующем примере.
Двойные фигурные скобки говорят Angular, что содержимое внутри них нужно интерполировать. Значение для title берется из класса компонента:
Когда приложение загружает компонент и его шаблон, браузер видит следующее:
Стили
Компонент может наследовать общие стили приложения из файла styles.css или переопределять их собственными стилями. Вы можете писать стили для конкретных компонентов прямо в декораторе @Component() или указывая путь к CSS-файлу.
Чтобы включить стили непосредственного в декоратор компонента, используется свойство styles :
Обычно компонент использует стили определяемые в отельном файле, указанном в свойстве styleUrls :
С помощью стилей для конкретных компонентов вы можете организовывать свой CSS так, чтобы его было легко поддерживать и переносить.
Резюме
Это ваше первое знакомство с Angular. На этом этапе всё должно быть настроено и готово к созданию Angular-приложения, а у вас быть базовое представление о том, как работает Angular. В следующей статье мы углубим эти знания и начнем создавать структуру вашего приложения списка дел.
Angular представляет фреймворк от компании Google для создания клиентских приложений. Прежде всего он нацелен на разработку SPA-решений (Single Page Application), то есть одностраничных приложений. В этом плане Angular является наследником другого фреймворка AngularJS. В то же время Angular это не новая версия AngularJS, а принципиально новый фреймворк.
Angular предоставляет такую функциональность, как двустороннее связывание, позволяющее динамически изменять данные в одном месте интерфейса при изменении данных модели в другом, шаблоны, маршрутизация и так далее.
Одной из ключевых особенностей Angular является то, что он использует в качестве языка программирования TypeScript.
Но мы не ограничены языком TypeScript. При желании можем писать приложения на Angular с помощью таких языков как Dart или JavaScript. Однако TypeScript все таки является основным языком для Angular.
Начало работы c Angular¶
Для работы с Angular необходимо установить сервер Node.js и пакетный менеджер npm, если они отсутствуют на рабочей машине. Для установки можно использовать программу установки node.js. Вместе с сервером она также установит и npm. При этом особого какого-то знания для работы с NodeJS и npm не требуется.
После установки необходимых инструментов создадим простейшее приложение. Для этого определим на жестком диске папку приложения. Путь она будет называться helloapp . В этой папке создадим новый файл package.json со следующим содержимым:
Данный файл устанавливает пакеты и зависимости, которые будут использоваться проектом. В секции dependencies в основном определяются пакеты angular, которые необходимы приложению для работы. В секции devDependencies прописаны только те пакеты, которые будут использоваться для разработки. В частности, это пакеты для работы с языком typescript (так как мы будем писать код приложения на языке TypeScript), а также пакеты, необходимые для сборки приложения в один файл с помощью сборщика webpack.
Затем откроем командную строку (терминал) и перейдем в ней к папке проекта с помощью команды cd :
И затем выполним команду npm install , которая установит все необходимые модули:
После выполнения этой команды в папке проекта должна появиться подпапка node_modules , которая содержит все используемые зависимости и пакеты.
Затем создадим в папке проекта подпапку, которую назовем src — она будет содержать все исходные файлы. И далее в папке src создадим подкаталог app .
Создание компонента Angular¶
В начале файла определяется директива import , которая импортирует функциональность модуля @angular/core , предоставляя доступ к функции декоратора @Component .
Далее собственно идет функция-декоратор @Component , которая ассоциирует метаданные с классом компонента AppComponent . В этой функции, во-первых, определяется параметр selector или селектор css для HTML-элемента, который будет представлять компонент. Во-вторых, здесь определяется параметр template или шаблон, который указывает, как надо визуализировать компонент. В этом шаблоне задана двусторонняя привязка с помощью выражений [(ngModel)]="name" и > к некоторой модели name .
И в конце экспортируется класс компонента AppComponent , в котором как раз определяется модель name — в данном случае это пустая строка.
Создание модуля приложения¶
Приложение Angular состоит из модулей. Модульная структура позволяет легко подгружать и задействовать только те модули, которые непосредственно необходимы. И каждое приложение имеет как минимум один корневой модуль. Поэтому создадим в папке src/app новый файл, который назовем app.module.ts со следующим содержимым:
Этот модуль, который в данном случае называется AppModule , будет входной точкой в приложение.
С помощью директив import здесь импортируется ряд нужных нам модулей. Прежде всего, это модуль NgModule . Для работы с браузером также требуется модуль BrowserModule . Так как наш компонент использует элемент input или элемент формы, то также подключаем модуль FormsModule . И далее импортируется созданный ранее компонент.
Запуск приложения¶
Этот код инициализирует платформу, которая запускает приложение, и затем использует эту платформу для загрузки модуля AppModule .
Также в папке src определим еще один файл, который назовем polyfills.ts со следующим кодом:
Данный файл определяет полифилы — инструменты, которые необходимы для поддержки приложения на Angular старыми браузерами.
Создание главной страницы¶
Далее определим в папке src главную страницу index.html приложения:
А в элементе body определен элемент <my-app> , в который собственно и будет загружаться приложение.
Определение конфигурации¶
Поскольку для определения кода приложения применяется язык TypeScript, поэтому также создадим в корневой папке проекта новый файл tsconfig.json :
Данный файл определяет настройки для компилятора TypeScript. Опция " compilerOptions " устанавливает параметры компиляции. А опция " files " определяет компилируемые файлы. В нашем случае это файл приложения — main.ts , который подтягивает все остальные файлы приложения, и файл полифилов polyfills.ts .
Angular.json¶
Для компиляции приложения мы будем использовать Angular CLI, поэтому нам надо описать поведение CLI с помощью файла angular.json . Итак, добавим в корневую папку проекта новый файл angular.json и определим в нем следующее содержимое:
Вкратце пройдемся по структуре файле. Вначале определяется параметр version . Он определяет версию конфигурации проекта.
Далее идет секция projects , которая определяет настройки для каждого проекта. В нашем случае у нас только один проект, который называется по названию каталога проекта — helloapp .
Проект определяет следующие опции:
- projectType : тип проекта. Значение " application " указывает, что проект будет представлять приложение, которое можно будет запускать в браузере
- root : указывает на папку файлов проекта относительно рабочей среды. Пустое значение соответствует корневой папке проекта, так как в данном случае рабочая среда и каталог проекта совпадают
- sourceRoot : определяет корневую папку файлов с исходным кодом. В нашем случае это папка src , где собственно определены все файлы приложения
- architect : задает настройки для построения проекта. В файле package.json определены команды build и serve , и для каждой из этих команд в секции architect заданы свои настройки.
Для каждой команды задается параметр builder , который определяет инструмент для построения проекта. Так, для команды " build " задано значение " @angular-devkit/build-angular:browser " — данный билдер для построения использует сборщик пакетов webpack. А для команды " serve " задано значение " @angular-devkit/build-angular:dev-server " — данный билдер запускает веб-сервер и развертывает на нем скомпилированное приложение.
Параметр options задает параметры построения файлов. Для команды " build " здесь определены следующие опции:
- outputPath : путь, по которому будет публиковаться скомпилированное приложение
- index : путь к главной странице приложения
- main : путь к главному файлу приложения, где собственно запускается приложение Angular
- polyfills : путь к файлу полифилов
- tsConfig : путь к файлу конфигурации TypeScript
- aot : указывает, будет ли использоваться компиляция AOT (Ahead-Of-Head) (предварительная компиляция перед выполнением). В данном случае значение true означает, что она используется
Для команды " serve " указана только одна опцияя — browserTarget , которая содержит ссылку на конфигурацию для команды build — " helloapp:build ". То есть по сути эта команда использует ту же конфигурацию, что и команда build .
Последняя опция defaultProject указывает на проект по умолчанию. В данном случае это наш единственный проект.
В итоге у нас получится следующая структура проекта:
Запуск проекта¶
И теперь, когда все готово, мы можем запустить проект. Для этого в командной строке (терминале) перейдем к папке проекта с помощью команды cd и затем выполним команду ng serve:
Консольный вывод проинформирует нас, какие файлы какого размера созданы. Кроме того, мы сможем увидеть адрес, по которому запущен тестовый веб-сервер — по умолчанию это " http://localhost:4200/ ". Если мы передаем команде флаг --open , как в случае выше, то Angular CLI автоматически открывае браузер с запущенным приложением. И мы можем обратиться к приложению:
Введем в текстовое поле какое-нибудь имя, и оно тут же отобразится в заголовке.
Важно отметить, что пока приложение запущено, мы можем поменять код, и Angular CLI почти моментально перекомпилирует и перезапустит приложение.
Недавно я был наставником ngHeroes. Мне очень понравилось помогать студентам и людям из других отраслей, которые хотели изучать веб-разработку на Angular. Многие из них хотели начать новую карьеру. Я был рад отметить, что посещаемость женщин больше, чем я ожидал, учитывая гендерный разрыв в нашей отрасли.
У студентов ngHeroes были компьютеры на MacOS, Linux и Windows. Нам удалось их запустить, но в процессе возникло несколько сложных моментов. В этой статье я сосредоточусь на установке инструментов и зависимостей, необходимых для разработки приложений Angular на компьютере под управлением Windows. Они почти одинаковы для других платформ.
1. Node.js
Первое, что вам нужно установить, это Node.js. Это среда выполнения JavaScript, которая может запускать веб-серверы, скрипты и консольные приложения. Многие инструменты веб-разработки используют Node.js.
Бесплатный курс «Laravel + Angular. Быстрый старт»
Изучите курс и узнайте, как создать веб-приложение с нуля на Angular и Laravel
Перейдите на сайт Node.js. На нем предлагаются 2 установочных пакета, исходя из вашей операционной системы и архитектуры процессора: LTS (долгосрочная поддержка) и Текущий.
Таблица 1. Поддержка Node.js в Angular CLI
Для нового приложения мы можем выбрать новейшую версию Angular CLI. На jsDelivr мы можем прочитать описание пакета для последней версии Angular CLI. На момент написания статьи это Angular CLI версии 7.0.5. В описании пакета мы также видим поддерживаемую версию Node.js.
Мы решили использовать новейший Angular CLI. Давайте вернемся на сайт Node.js, загрузим установщик последней версии LTS, поддерживаемой Angular CLI, и запустим его с правами администратора.
Если мастер установки спросит, включать ли Boxtstarter в установку, включите его. Подробнее об этом через минуту. Подождите, пока закончится установка. Это может занять некоторое время и даже может потребовать перезагрузки.
Чтобы убедиться, что Node.js установлен, откройте терминал (командную строку) и запустите node -v, чтобы отобразить установленную версию Node.js.
2. Инструменты сборки Windows
Установка инструментов сборки Windows с помощью NPM CLI
Мы решили использовать новейшую версию Angular CLI, но прежде чем мы сможем ее установить, нам нужно позаботиться о дополнительных зависимостях.
В частности, некоторые инструменты компиляции используются для задач пакетом node-gyp до и после установки для различных пакетов, таких как Angular CLI.
Для Windows нам нужны Python 2.7, инструменты сборки Visual Studio и инструменты сборки C++. К счастью, мы можем установить их все как один пакет, используя интерфейс командной строки NPM.
Если вы ранее установили Node.js с включенной опцией Boxstarter, у вас уже есть эти зависимости. Перейдите к шагу 3.
Выполните следующую команду, чтобы установить все специфичные для Windows зависимости для Angular CLI. Для установки из общедоступного реестра NPM используется интерфейс командной строки NPM (Node Package Manager). Вы установили интерфейс командной строки NPM с Node.js.
Для начала, установим Angular CLI (интерфейс командной строки Angular), который очень поможет нам при подготовке проекта Angular и разработке проекта Angular в целом. Чтобы установить Angular CLI , введите в командной строке следующую команду:
После завершения установки мы собираемся создать новый проект.
Откройте код Visual Studio и в окне терминала ( CTRL+
) перейдите по пути, по которому вы хотите разместить свой проект, и выполните команду:
Появятся два вопроса. Первый вопрос - хотим ли мы, чтобы в нашем проекте была создана маршрутизация, а второй - о том, какой стиль мы хотим в нашем проекте. Мы ответим НЕТ (N) на первый вопрос и (CSS - просто нажмите Enter) на второй.
Создание проекта займет некоторое время. После завершения процесса создания мы собираемся открыть папку проекта внутри нашего редактора:
Сторонние библиотеки как часть подготовки проекта Angular
Мы собираемся использовать библиотеку начальной загрузки для стилизации, поэтому давайте установим ее с помощью команды:
Он установит библиотеку, но нам также необходимо импортировать ее путь в файл angular.json . Поместите его прямо над styles.css :
После установки библиотеки начальной загрузки мы собираемся установить для нее определения типов. Для установки введите эту команду:
Сразу после этого давайте импортируем это определение типа в файл tsconfig.app.json :
Чтобы установить библиотеку JQuery, введите следующую команду:
Для типов JQuery мы должны выполнить:
Вот так должен выглядеть массив скриптов в файле angular.json:
И измените импорт для типов:
Для установки JQueryUI выполните:
а для типов выполнить:
Вот так должны выглядеть стили и массив скриптов:
Импорт для типов должен выглядеть так:
На этом установка зависимостей завершается.
Теперь все библиотеки установлены и импортированы в нужные файлы.
Следующим шагом будет добавление наших компонентов в проект.
Компоненты в Angular
Каждый компонент должен импортировать Component из пакета @angular/core . Мы будем импортировать больше вещей, когда они нам понадобятся. Также вы могли заметить декоратор @Component внутри кода. Это место, где мы создаем наш селектор (он такой же, как тег app-root в файле index.html). Кроме того, мы связываем шаблон HTML для этого компонента с templateUrl и файлы CSS с этим компонентом с помощью styleUrls . StyleUrls - это массив строк, разделенных запятыми. В конце концов, мы создаем наш класс для компонента.
Теперь, если мы посмотрим на файл app.module.ts , который очень важен для подготовки проекта Angular и вообще для разработки, мы заметим этот код:
В этом файле мы собираемся импортировать необходимые модули, компоненты и сервисы. Мы собираемся использовать массив объявлений для импорта наших компонентов и массив imports для импорта наших модулей. Также мы собираемся использовать массив провайдеров для регистрации наших сервисов.
Создание нового компонента
Чтобы создать новый компонент с именем Home, давайте выполним следующую команду:
С помощью этой команды мы создаем компонент Home с тремя файлами (.ts, .html, .css). А добавляя флаг –skipTests, мы предотвращаем создание тестового файла.
Теперь мы можем проверить Home component :
Здесь мы импортируем интерфейс OnInit , который определяет функцию ngOnInit . Эта функция будет выполнять любую внутреннюю логику, как только компонент инициализируется. Обратите внимание на конструктор. Конструктор предназначен только для внедрения сервиса в компонент. Для любого действия, которое необходимо выполнить при инициализации компонента, используйте метод ngOnInit.
Подробнее про App.Module
Если мы проверим файл app.module.ts , мы увидим, что наш новый компонент импортирован с помощью нашей предыдущей команды:
Итак, как мы видим, Angular CLI создает все это за нас.
Хотя одного модуля достаточно для всего приложения, мы все равно хотим создать больше модулей.
Модули проще поддерживать, а также большее количество модулей дает нам преимущество в виде отложенной загрузки контента. Это означает, что наше приложение будет загружать только контент, связанный с этим конкретным модулем, на который мы указываем, а не все приложение.
Дополнительный контент в компоненте Home
Давайте изменим файл компонента Home:
Заключение
Прямо сейчас у нас есть рабочий компонент и приложение Angular, которое вы можете запустить в своем браузере. Но это только начало. У нас впереди долгий путь, потому что есть еще много важных функций Angular, которые нужно ввести в проект.
Прочитав этот пост, вы узнали:
- Способ установки сторонних библиотек
- Обзор компонентов Angular
- Как создавать компоненты Angular
- И несколько фактов о модулях в Angular
Спасибо за чтение и надеюсь, что вы нашли в нем что-то полезное.
В следующей статье, мы покажем вам, как создать навигацию в проекте, а также как использовать маршрутизацию.
Читайте также: