آماده سازی محیط برنامه نویسی SharePoint framework

مسیر یادگیری SPFX

شما می توانید از ویژوال استودیو یا محیطهای دیگر متناسب برای توسعه مورد پسند خود برای ایجاد راهکارهای مناسب از SharePoint Framework  در محیط های Mac، کامپیوتر و یا لینوکس استفاده کنید.

قبل از شروع به کار با دقت به ویدیوی زیر مطمان شوید که محیط شیرپوینت شما آماده برای شروع کار میباشد.

نصب ابزارهای برنامه نویسی شیرپوینت فریم ورک (spfx)

نصب NodeJS

یکی از این ابزارهای توسعه دهنده NodeJS می باشد که نکاتی در رابطه با این ابزارتوسعه دهنده در این بخش ارائه می گردد.

ورژن 8 NodeJS LTS  را نصب کنید.

  • اگر شما در محیط ویندوز هستید، می توانید از نصب کننده های msi بعنوان ساده ترین راه برای تنظیم NodeJS استفاده کنید.
  • اگر شما NodeJS را در حال حاضر نصب کرده اید، با استفاده از node -v چک کنید که شما آخرین نسخه را داشته باشید. باید به ورژن رایج LTS را بازگردد.
  • اگر از محیط Macاستفاده می کنید، توصیه می کنیم برای نصب و مدیریت NodeJS از homebrew استفاده کنید.

 

نصب ویرایشگر کد یا همان code editor

شما می توانید از هر ویرایشگر کد یا IDE که از توسعه client-side پشتیبانی می کند را برای ساخت وب پارت خود استفاده کنید، از قبیل:

  • Visual Studio Code
  • Atom
  • Webstorm

در این مقاله برای مثال ها از کد ویژوال استودیو استفاده می کنیم، اما می توانید از هر ویرایشگر کد دیگر نیز استفاده کنید.

اگر شما از  Ubuntu استفاده می کنید، شما باید با استفاده از دستور زیر، ابزار کامپایلر (compiler) را نصب کنید:

sudo apt-get install build-essential

و اگر از Fedora استفاده می کنید، شما باید با استفاده از دستور زیر، ابزار کامپایلر را نصب کنید:

sudo yum install make automake gcc gcc-c++ kernel-devel

نصب Yeoman و gulp

مولد Yeoman به شما کمک می کند تا پروژه های جدید را شروع کنید و بهترین شیوه ها و ابزارهای موثر را معرفی می کند. ابزارهای  توسعه SharePoint client-side  مانند مولد Yeoman که برای ایجاد وب پارتهای جدید استفاده می گردد امکان ایجاد محیط آزمایش وب پارتها را برای شما فراهم مینماید.
دستور زیر را وارد کنید تا Yeoman نصب شود:

npm install -g yo gulp

نصب Yeoman sharepiont

مولد Yeoman بخش وب شیرپوینت به شما کمک می کند تا به سرعت بالا یک پروژه شیرپوینت client-side را با استفاده از ابزار toolchain با ساختار مناسب راه اندازی کنید.
برای نصب مولد SharePoint Framework Yeoman به صورت کلی، دستور زیر را وارد کنید:

npm install -g @microsoft/generator-sharepoint

به منظور مطالعه بیشتر در مورد چهارچوب و پیکره بندی پروژه ها توسط ابزار Yeoman Sharepoint میتوانید به این لینک مراجعه نمایید.

قابل اطمینان کردن (trust) گواهینامه (certificate) مرتبط با محیط توسعه

هنگام آزمایش راهکارهای سفارشی در محیط توسعه از وب سرور رایانه خود، SharePoint Framework که به طور پیش فرض HTTPS مورد استفاده قرار میگیرد. این کار نیز با استفاده از گواهی SSL که توسط رایانه شما صادر شده است، اجرا میشود. گواهی های SSL که توسط برنامه نویس توسعه داده شدند اعتبار کافی ندارند و باید محیط توسعه شما پیکربندی گردد.
وظیفه مفید در هر پروژه SharePoint Framework در قالب یک gulp گنجانده شده است. شما می توانید انتخاب کنید که این کار را هم اکنون انجام دهید یا پس از تکمیل پروژه و اجرای آن، که در مقاله قسمت بعدی آموزش آن را به حضورتان تقدیم خواهیم کرد.
هنگامی که یک پروژه با مولدYeoman برای SharePoint Framework ایجاد کردید، فرمان زیر را از داخل پوشه اصلی پروژه اجرا کنید.

gulp trust-dev-cert

ابزارهای زیر ممکن است برای شما مفید باشد، ما صرفا نام آنها را اینجا بیان میکنیم که شما کافیست هر یک از خطوط زیر را گوگل کنید تا با آنها بیشتر آشنا شوید.

• Fiddler
• Postman
• Cmder for Windows
• Oh My Zsh for Mac
• Git source control tools

شما در حال حاضر آماده اید برای ساخت اولین بخش وب client-side هستید!

رفع ایرادات احتمالی

آماده سازی شیرپوینت 2016 برای توسعه SPFX

 شیرپوینت سرور 2016 با استفاده ازv1.1. (SPFx) SharePoint Framework در زمان انتشار v1.1، NodeJS از NodeJS v6.x به v8.x منتقل شد. در این بروزرسانی، NodeJS یک تغییر را ایجاد کرد که به طور پیش فرض از HTTP1 به HTTP2 تغییر یافته است. برای برخی،که با SPFx کار می کنند حتما با این مسائل مواجه شدند. نسخه بعدی SPFx این مسائل را حل کرد، اما کسانی که هنوز با SPFx v1.1 کار می کنند (مانند افرادی که با SharePoint Server 2016) ممکن است این افراد نیز با این مشکل روبرو گردند.
برای حل این مسئله، متغیر موثر زیر را برای آموزش NodeJS که برای استفاده از HTTP1 به جای HTTP2 پیش فرض تنظیم کنید: NODE_NO_HTTP2 = 1.

اطلاعات بیشتر در این رابطه در این مقاله از سایت مایکروسافت

عدم اعتبار گواهی دیجیتال

در بعضی موارد، اجرای دستور gulp trust-dev-cert  اثر دلخواه از اعتبار گواهی تکمیل توسعه خود را بر روی سیستم شما ندارد. در موارد نادر از این قبیل ، ممکن است لازم باشد یک پوشه پنهانی را که در پوشه پروفایل شما ایجاد شده است را حذف کنید. با استفاده از این دستور   <homedir> /. gcb-serve-data تعیین محل و سپس حذف پوشه انجام می گردد. باید مجددا گواهی اعتباردهی شود

عدم نصب بسته ها با NPM - Corporate Proxies

اگر پشتیبانی محیط توسعه شما یک پروکسی شرکتی باشد، شما باید NPM را برای استفاده از آن پروکسی پیکربندی کنید.
مراجعه به مستندات npm-config در مورد چگونگی پیکربندی محیط توسعه در پروکسی شرکتی …به طور خاص تنظیمات پروکسی و http-proxy. اطلاعات بیشتر: نحوه تنظیم Node.js و NPM بعد از پروکسی وب شرکتی.

دیدگاهتان را بنویسید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *