Git dependencies in Flutter pubspec

سلام به فلاتری های عزیز ???

حتمن همتون با فایل pubspec.yaml و نحوه ی استفاده از پکیج های pub.dev آشنایی دارین.

توی این مینی آموزش میخوایم نحوه ی استفاده از یه Git Repository رو با هم یاد بگیریم.

  • اول نحوه ی اضافه کردن یه Public Git Repository از github رو با هم بررسی میکنیم.
  • و بعد هم استفاده یه از Private Git Repository از gitlab رو یاد میگیریم.

فک کنم همه با روش معمولی اضافه کردن یه پکیج به پروزه فلاتری آشنایی دارین ولی با هم یه مرور میکنیم.

مثلن اگه بخوایم پکیج flutter_bloc رو به پروژم اضافه کنیم.

میبینیم که flutter_bloc: ^7.2.0 رو به قسمت dependencies اضافه کردیم. فعلن با علامت ^ که قبل ورژن اومده کاری نداریم و توی مقاله های دیگه راجبش صحبت میکنیم.

حالا همین پکیج BLoC رو از طریق repository گیت هاب به پروژمون اضافه میکنیم.

وقتی وارد repository گیت هاب این پکیج میشیم یه پروژه با اسم bloc میبینیم ک زیر مجموعش پکیج های مختلف مرتبط با اون قرار گرفته. آدرس گیت هاب پروژه اصلی (bloc) رو از اینجا میتونید دنبال کنید.وقتی وارد این ادرس میشیم قسمت های زیر رو میبینیم.

وارد packages میشیم.

و توی پروژه هایی که در این دایرکتوری وجود داره flutter_bloc رو انتخاب میکنیم.

حالا بریم سراغ فایل pubspec و اضافه کردن این پکیج از طریق repository گیت هاب.

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

  • url

توی این قسمت باید ادرس repository گیت هاب پروژه رو بدیم.گفتیم که پروژه اصلی با نام bloc ساخته شده و بعدش زیر مجموعش پکیج های مربوطه قرار گرفتن. پس به مسیر پروژه اصلی میریم.

و با کلیک روی دکمه سبز رنگ (بالا سمت راست ) آدرسی رو که داده رو کپی میکنیم.

و همین ادرس رو توی قسمت url قرار میدیم.

  • ref

توی این قسمت میتونیم اسم branch مورد نظر یا ای دی commit مورد نظر رو قرار بدیم.

من روی master گذاشتم.

  • path

توی این قسمت هم path پروژه مورد نظر خودمون رو میگذاریم. ما flutter_bloc رو میخاستیم.

? در صورت خالی بودن ref از branch اصلی استفاده میکنه.

?در صورت خالی بودن path از url برای clone کردن استفاده میکنه.

???نکته مهمی که هست ادرسی که میدیم حتمن باید توی دایرکتوری اصلیش فایل pubspec وجود داشته باشه. مثلن اینجا آدرسی که ما در نهایت داریم استفاده میکنیم

https://github.com/felangel/bloc.git + packages/flutter_bloc

هست و توی دایرکتوری اصلی این آدرس حتمن باید فایل pubspec وجود داشته باشه (درواقع چیزی که داریم اضافه میکنیم خودش یه پروژه یا پکیج فلاتری باشه).


خب تا اینجا نحوه اضافه کردن یه پکیج از طریق public git repository رو دیدیم. حالا بریم سراغ private repository ها و برای این یک مثال از gitlab میزنیم.

همه مراحل دقیقن مثل public git repository هست فقط برای استفاده از private repository ها نیاز به یه username و password داریم.

در این حالت فقط فرمت url تغییر میکنه و به شکل زیر میشه.

میبینید url به شکل زیر هست .

https://<deploy_token_name><deploy_token_password>@gitlab.com/my_user_name/package1.git

ینی 

https://  + <deploy_token_name>  + <deploy_token_password>  + @  + gitlab project address.

پس همه چیز مثل قبل هست و فقط دو تا پارامتر <deploy_token_name> و <deploy_token_password> رو باید مقدار دهی کنیم.

پس باید وارد تنظیمات پروژه گیت لب خودمون بشیم.برای این کار اول وارد پٰروژه خودمون میشیم و از منوی سمت چپ settings و بعد repository رو میزنیم.

حالا از بخش Deploy tokens گزینه Expand رو میزنیم.

حالا پارامتر های مورد نیاز (Name , Expiration date , Username و...) رو تکمیل میکنیم و روی create deploy token میزنیم.

و بعد از ساخته شدن deploy token میتونیم username و password رو کپی کنیم و توی url مورد نظر قرار بدیم.


????خب اینم از این آموزش . امیدوارم واستون مفید بوده باشه.????


برای دریافت آموزش های بیشتر و شرکت در چالش های فلاتری, کانال فلاتری Flutter Challenge(چالش فلاتر) رو دنبال کن.