create-a-new-react-app.md

id	title	permalink	redirect_from	prev	next
create-a-new-react-app	Yeni React Applikasiyası Yarat	docs/create-a-new-react-app.html	docs/add-react-to-a-new-app.html	add-react-to-a-website.html	cdn-links.html

Ən yaxşı istifadəçi və developer təcrübəsi üçün inteqrasiya olunmuş toolchain istifadə edin.

Bu səhifə, göstərilən məsələləri həll etməyə kömək edən React toolchain-lərindən danışır:

• Çoxlu fayllara və komponentlərə böyümə.
• NPM-dən kitabxanaların işlədilməsi.
• Çox yaranan səhvlərin erkən tapılması.
• Development-də CSS və JS-in canlı redaktə edilməsi.
• Produksiya üçün nəticənin optimallaşdırılması.

Bu səhifədə tövsiyyə olunan toolchain-lər heç bir konfiqurasiya tələb etmir.

Sizə Toolchain Lazım Olmaya Bilər {#you-might-not-need-a-toolchain}

Əgər yuxarıda göstərilən problemlər ilə qarşılaşmır və ya JavaScript alətlərindən istifadə etmək istəmirsinizsə React-i HTML səhifəsinə <script> təqi ilə əlavə etməyi (fakultativ olaraq JSX ilə) tövsiyyə edirik.

Bu, React-i mövcud veb səhifəsinə əlavə etməyin ən asan yoludur. Siz, faydalı gördüyünüz halda istədiyiniz zaman daha böyük toolchain əlavə edə bilərsiniz!

Tövsiyyə Edilən Toolchain-lər {#recommended-toolchains}

React komandası əsasən aşağıdaki həlləri tövsiyyə edir:

• React-i öyrənmək və ya tək-səhifəli applikasiya yaratmaq üçün Create React App-dən istifadə edin.
• Node.js ilə server tərəfindən render edilmiş veb səhifə yaratmaq üçün Next.js-dən istifadə edin.
• Statik kontent əsasında qurulmuş veb səhifə yaratmaq üçün Gatsby-dən istifadə edin.
• Komponent kitabxanası yaratmaq və ya mövcud koda React inteqrasiya etmək üçün Daha Elasktik Toolchain-lərdən istifadə edin.

Create React App {#create-react-app}

Create React App, React-i öyrənmək və React-də yeni tək-səhifəli applikasiya yaratmaq üçün çox rahat mühit təmin edir.

Bu alət ən son JavaScript xüsusiyyətlərini istifadə etmək üçün development mühiti yaradır, yaxşı developer təcrübəsi ilə proqramçıları təmin edir, və applikasiyanı produksiya üçün optimallaşdırır. Bu aləti işlətmək üçün Node >= 8.10 və npm >= 5.6 tələb edilir. Layihə yaratmaq üçün göstərilən əmri icra edin:

npx create-react-app my-app
cd my-app
npm start

Qeyd

İlk sətrdə yazılan npx səhv deyil -- bu npm 5.2+ ilə gələn paket icra edən alətdir.

Create React App backend məntiqi və ya verilənlər bazası idarə etmir; bu yalnız frontend üçün yaratma konveyeri (build pipeline) yaradır. Siz bunu istədiyiniz backend ilə işlədə bilərsiniz. Bu toolchain pərdə arxasında Babel və webpack işlədir. Lakin siz bu alətlər haqqında heç nə bilməyə bilərsiniz.

Applikasiyanı produksiyaya yerləşdirməya hazır olduqda npm run build əmri, applikasiyanın produksiya üçün optimallaşmış versiyasını build direktoriyasında yaradacaq. Create React App haqqında əlavə məlumat üçün README faylınını və ya İstifadəçi Dərsliyini oxuyun.

Next.js {#nextjs}

React-də statik və server ilə render edilmiş applikasiyalar yaratmaq üçün populyar və yüngül freymvorklardan biri Next.js-dir. Bu freymvork stilləmə və routing həlləri ilə hazır gəlir. Bu toolchain server mühitində Node.js işlətdiyinizi fərz edir.

Next.js haqqında əlavə məlumat üçün rəsmi dərsliyə baxın.

Gatsby {#gatsby}

React-də statik veb səhifə yaratmaq üçün ən yaxşı yol Gatsby işlətməkdir. Bu toolchain React komponentlərindən istifadə edir. Lakin son nəticədə əvvəlcədən render olunmuş HTML və CSS faylları yaradaraq ən təz yükləmə sürətinin olacağını qarantiyalayır.

Gatsby haqqında öyrənmək üçün rəsmi sənədlərə və start kitlər qalereyasına baxın.

Daha Elastik Toolchain-lər {#more-flexible-toolchains}

Aşağıda göstərilən toolchain-lər daha çox seçim və elastiklik təklif edirlər. Biz bu alətləri daha təcrübəli istifadəçilərə tövsiyyə edirik:

• Neutrino aləti webpack-in gücünü əvvəlcədən hazırlanmış şablonların sadəliyi ilə birləşdirir. Bu alət, React applikasiyaları və React komponentləri üçün şablonlar təmin edir.

• nwb React komponentlərini npm-ə dərc etməyi asanlaşdırır. Bu aləti React applikasiyalarında işlətmək də mümkündür.

• Parcel React ilə işlənə bilən çevik və sıfır konfiqurasiyalı veb applikasiya paketləyənidir.

• Razzle konfiqurasiya tələb etməyən server ilə render etmə freymvorkdur. Bu framevork Next.js-dən daha elastikdir.

Sıfırdan Toolchain Yaratmaq {#creating-a-toolchain-from-scratch}

JavaScript yaratma toolchain-i aşağıdaki elementlərdən ibarətdir:

• Yarn və ya npm kimi paket meneceri. Bu mecerlər paketlərdən ibarət olan çox böyük ekosistemdən faydalanmağa və paketləri yükləməyə və ya yeniləməyə imkan yaradır.

• webpack və ya Parcel kimi paketləmə qurğuları. Bu qurğular modulyar kodun yazılmasına və modulları kiçik paketlərə paketləyib yükləmə zamanını optimallaşdırılmasına imkan yaradır.

• Babel kimi kompilyator. Bu kompilyator ilə köhnə brauzerlərdə işləyən modern JavaScript kodu yazmaq mümkündür.

Əgər öz JavaScript toolchain-inizi quraşdırmağa üstünlük verirsinizsə Create React App-in bəzi funksiyalarını yenidən tətbiq edən bu yazını oxuyun.

Xüsusi toolchain-in produksiya üçün düzgün quraşdırıldığından əmin olun.