آموزش نصب Electron

قبل از شروع آموزش نصب Electron پیشنهاد می شود، نرم افزارهای موردنیاز جهت کار راحت تر با Electron را نصب نمایید. جهت ساخت و ویرایش کدهای برنامه نویسی پیشنهاد ما ادیتور VS Code یا Atom می باشد.
همچنین Git که کار با Command Prompt را برای کاربران راحت تر کرده است. وارد سایت git-scm.com شده و نسخه متناسب با سیستم عامل خود را دریافت کنید.

برنامه VS Code را باز نموده و یک پوشه را به عنوان مسیر پروژه خود انتخاب کنید. (دلخواه : مناسب جهت ساخت اولین پروژه با الکترون)
جهت وارد کردن دستورات از منوی View گزینه Integerated Terminal را بزنید. همانند CMD ویندوز شما قادر خواهید بود دستورات مد نظر را وارد نمایید.

آموزش نصب الکترون

برای نصب باینری های پیش ساخته Electron از npm استفاده میکنیم. روش بهتر این است که Electron را به عنوان یک وابستگی پیشرفته در اپلیکیشن تان نصب کنید:
npm install electron --save-dev

با اضافه کردن فلگ –save نصب نسخه ی prebuilt الکترون به عنوان یکی از وابستگی ها صورت میگیرد. همچنین فلگ dev اعلام میکند بسته ی الکترون را در وابستگی های توسعه و دیباگ قرار گیرد.

نصب سراسری (Global)

همچنین شما می توانید دستور Electron را بصورت سراسری در $PATH نصب کنید:

npm install electron -g

تنظیمات دلخواه نصب Electron

اگر بخواهید ساختار دانلود شده را تغییر دهید (e.g., ia32 on an x64 machine) می توانید از نشانه –arch با نصب npm استفاده کنید یا متغییر محیطی npm_config_arch را تنظیم کنید:

npm install --arch=ia32 electron

اگر تمایل داشتید ساختار نصب را تغییر دهید میتوانید از دستورهای زیر برای تغییر معماری سیستم عامل استفاده کنید.
npm install --platform=win32 electron

پراکسی ها

اگر نیاز به استفاده از یک پراکسی HTTP دارید می توانید این متغیرهای محیطی را تغییر دهید

Custom Mirrors and Caches

درطول نصب، ماژول electron برای دانلود بینداری های پیش ساخته پلتفرم شما، درخواست electron-download می کند. این کار با اتصال صفحه انتشار دانلود GitHub انجام خواهد شد. (https://github.com/electron/electron/releases/tag/v$VERSION,  جایی که $VERSION ورژن دقیق electron است.)
اگر به GitHub دسترسی ندارید یا نیاز به آماده سازی یک ساخت دلخواه دارید، می توانید این کار را با تامین یک mirror یا یک پوشه Cache موجود انجام دهید.

منابع کمکی

میتوانید از متغیرهای محیطی برای لغو URL اصلی، مسیری که در آن به دنبال بینداری های Electron هستید و FileName بینداری استفاده کنید. url استفاده شده توسط electron-download مانند نمونه ترکیب شده است:
url = ELECTRON_MIRROR + ELECTRON_CUSTOM_DIR + ‘/’ + ELECTRON_CUSTOM_FILENAME

مثال استفاده از China mirror:
ELECTRON_MIRROR=”https://npm.taobao.org/mirrors/electron/”

Cache

همینطور شما می توانید Cache محلی را جایگزین کنید. electron-download باینری های دانلود شده را در یک پوشه محلی ذخیره می کند تا شبکه شما را تحت تاثیر قرار ندهد. میتوانید برای تهیه ساختارهای دلخواه Electron یا دوری از ارتباط با شبکه، از آن پوشه cache استفاده کنید.
لینوکس: $XDG_CACHE_HOME یا ~/.cache/electron/
مکینتاش : ~/Library/Caches/electron/
ویندوز: $LOCALAPPDATA/electron/Cache or ~/AppData/Local/electron/Cache/
در محیط هایی که از ورژن های قدیمی تر Electron استفاده می کنند، ممکن است در ~/.electron هم cache پیدا کنید.
همچنین می توانید مکان cache محلی را با تهیه یک متغیر محلی ELECTRON_CACHE جایگزین (override) کنید.
Cache شامل فایل فشرده نسخه، همچنین یک checksum است که به عنوان یک فایل متنی ذخیره شده. یک cache عادی ممکن است به این صورت باشد:

├── electron-v1.7.9-darwin-x64.zip
  ├── electron-v1.8.1-darwin-x64.zip
  ├── electron-v1.8.2-beta.1-darwin-x64.zip
  ├── electron-v1.8.2-beta.2-darwin-x64.zip
  ├── electron-v1.8.2-beta.3-darwin-x64.zip
  ├── SHASUMS256.txt-1.7.9
  ├── SHASUMS256.txt-1.8.1
  ├── SHASUMS256.txt-1.8.2-beta.1
  ├── SHASUMS256.txt-1.8.2-beta.2
  ├── SHASUMS256.txt-1.8.2-beta.3

اشکال یابی

وقتی فرمان npm install electron در حال اجراست، بعضی از کاربران با خطاهایی روبرو می شوند. در بیشتر موارد این خطاها به دلیل مشکلات شبکه هستند و در بسته electron npm موضوع مهمی نیستند.
خطاهایی مثل ELIFECYCLE, EAI_AGAIN, ECONNRESET, و ETIMEDOUT همه آثار مشکلات شبکه هستند. بهترین راه حل قطع و وصل شبکه یا کمی انتظار و امتحان کردن مجدد نصب است.
همچنین اگر نصب توسط npm شکست خورد، می توانید پوشه Electron را از electron/electron/releases دانلود کنید.
اگر نصب با خطای EACCESS شکست خورد، باید مجوزهای npm خود را معین کنید.
اگر خطاهای بالا همچنان باقی ماند ممکن است نشانه unsafe-perm نیاز به تنظیم صحیح داشته باشد:
sudo npm install electron --unsafe-perm=true

در شبکه های کندتر برای نشان دادن پیشرفت دانلود بهتر است از نشانه –verbose استفاده شود:
npm install --verbose electron

در صورت نیاز دانلود مجدد را انجام داده و فایل SHASUM متغیر محیطی force_no_cache را تنظیم کند.

باز هم در صورتی که نتوانستید از طریق Package manager اقدام به نصب الکترون نمایید، از مخزن گیت هاب آخرین نسخه را دانلود نموده و در برنامه ایمپورت نمایید.

در مقاله بعدی سراغ ساخت اولین اپلیکیشن با Electron خواهیم رفت 🙂

1 Star2 Stars3 Stars4 Stars5 Stars (2 votes, average: 5٫00 out of 5)
Loading...
counter customizable free hit