پرش به محتویات

نصب Elm

در این قسمت، فرآیند راه‌اندازی یک فایل اجرایی به نام elm را توضیح می‌دهیم. در ادامه، لینک‌های نصب این فایل قرار دارند:

پس از اتمام نصب، ترمینال را در کامپیوتر خود باز کنید. ممکن است به نام cmd.exe یا Command Prompt در ویندوز شناخته شود.

ترمینال

با رفتن به دسکتاپ در ترمینال شروع کنید:

# Windows (but with <username> filled in with yours)
cd C:\Users\<username>\Desktop

# Mac and Linux
cd ~/Desktop

مرحله بعدی آشنا شدن با دستور elm است. من در یادگیری دستورات ترمینال بسیار مشکل داشتم، بنابراین سخت کار کردم تا دستور elm را آسان و کاربردی ارایه دهم. بیایید به چند سناریوی رایج بپردازیم.

elm init

این دستور، یک پروژه جدید Elm را در دایرکتوری فعلی ایجاد می‌کند:

elm init

سعی کنید این دستور را اجرا کنید تا یک فایل elm.json و یک دایرکتوری src/ ایجاد شود:

  • elm.json پروژه شما را توصیف می‌کند.
  • src/ شامل سورس کد پروژه است.

حالا سعی کنید فایلی به نام src/Main.elm در ویرایشگر کد ایجاد و کد نمونه را از برنامه دکمه‌ها کپی کنید.

elm reactor

این دستور، به شما کمک می‌کند تا پروژه Elm را بدون درگیر شدن با ترمینال بسازید. کافی است آن را در دایرکتوری اصلی پروژه به شیوه زیر اجرا کنید:

elm reactor

با اجرای این دستور، یک سرور در نشانی http://localhost:8000 راه‌اندازی می‌شود. می‌توانید هر فایل Elm را اجرا کنید تا ببینید چگونه کامپایل می‌شود. دستور elm reactor را اجرا کنید، به لینک localhost:8000 بروید و سعی کنید فایل src/Main.elm را بررسی کنید!

elm make

این دستور، سورس کد Elm را به جاوااسکریپت کامپایل می‌کند:

# Create an index.html file that you can open in your browser.
elm make src/Main.elm

# Create an optimized JS file to embed in a custom HTML document.
elm make src/Main.elm --optimize --output=elm.js

سعی کنید این دستورات را بر روی فایل src/Main.elm اجرا کنید.

این روش، متداول‌ترین شیوه برای کامپایل سورس کد Elm است. زمانی که مدیریت پروژه با elm reactor دشوار می‌شود، استفاده از این روش پیشنهاد می‌شود.

این دستور، پیام‌های مشابهی را تولید می‌کند که در ویرایشگر آنلاین و elm reactor مشاهده کرده‌اید. سال‌ها کار در این زمینه انجام شده است، اما اگر پیام غیر مربوطی مشاهده کردید، لطفا آن را در صفحه کاتالوگ پیام خطا گزارش دهید. همیشه امکان بهبود وجود دارد!

elm install

بسته‌های Elm در وبسایت package.elm-lang.org قرار دارند.

فرض کنید می‌خواهید برای انجام برخی درخواست‌های HTTP از بسته‌های elm/http و elm/json استفاده کنید. این بسته‌ها را می‌توانید با استفاده از دستورات زیر در پروژه خود نصب کنید:

elm install elm/http
elm install elm/json

این دستورات، با افزودن و مدیریت وابستگی‌ها در فایل elm.json، امکان استفاده از آن‌ها را برای شما فراهم می‌کنند. این کار به شما اجازه می‌دهد که با فراخوانی import Http در فایل سورس کد پروژه، از توابعی مانند Http.get استفاده کنید.

نکات و ترفندها

اول، نگران به خاطر سپردن تمام این موارد نباشید!

همیشه می‌توانید دستور elm --help را اجرا کنید تا یک نمای کلی از قابلیت‌های elm به دست آورید.

همچنین می‌توانید دستوراتی مانند elm make --help و elm repl --help را اجرا کنید تا نکاتی درباره یک دستور خاص به دست آورید. اگر می‌خواهید بررسی کنید که کدام پرچم‌ها در دسترس هستند و چه کاری انجام می‌دهند، این روش خوبی است.

دوم، نگران نباشید اگر کار در ترمینال مدتی برای شما طول بکشد!

بیش از یک دهه است که از آن استفاده می‌کنم و هنوز هم نمی‌توانم به خاطر بسپارم که چگونه فایل‌ها را فشرده کنم یاتمام فایل‌های Elm را در یک دایرکتوری پیدا کنم. هنوز هم بسیاری از چیزها را جستجو می‌کنم!

یادداشت مترجم

استفاده از فایل باینری Elm که به صورت global در سیستم عامل نصب می‌شود، شاید گزینه مناسبی برای مدیریت پروژه نباشد. در این صورت، می‌توانید از پروژه elm-tooling برای دانلود و نصب کامپایلر همراه با سایر ابزارهای کاربردی استفاده کنید. یکی از مهم‌ترین قابلیت‌های این پروژه، در اختیار گذاشتن نسخه‌های مختلف از کامپایلر و ابزارهای کاربردی به صورت جداگانه برای هر پروژه Elm است که فرآیند مدیریت پروژه را آسان می‌کند. این ابزارها عبارتند از:

elm-format
قالب‌بندی خودکار کد بدون تنظیمات اولیه همراه با استاندارد واحد
elm-json
مدیریت بسته‌ها و وابستگی‌های نرم‌افزاری
elm-test-rs
اجرای سریع آزمون کد