ارسال پروژه از اندروید استودیو به گیت لب GitLab

ارسال پروژه از اندروید استودیو به گیت لب GitLab ، کمتر کسی است که برنامه نویس باشد اما با گیت آشنا نباشد چرا که استفاده از گیت برای هر برنامه نویس یک امر ضروری است. اما چه چیزی این الزام را به وجود می آورد؟

معمولا زمانی که اسم گیت را می آوریم، همه تصور این چنینی دارند که گیت برای تیم های برنامه نویسی است و برنامه نویس های فریلنسر که خود به طور کامل یک پروژه را از صفر تا صد توسعه می دهند نیازی به گیت ندارند!

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

ارسال پروژه از اندروید استودیو به گیت لب GitLab

گیت لب (Gitlab) یکی از محبوب ترین سرویس های گیت در دنیا است و دلیل محبوبت روز افزون گیت لب نیز این است که شما می توانید به صورت رایگان پروژه های خود را به صورت شخصی یا private ایجاد کنید. بر خلاف گیت هاب (GitHub) که برای ساخت پروژه های شخصی شما ملزم به پرداخت هزینه هستید.

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

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

ایجاد یک repository در گیت لب برای ارسال پروژه از اندروید استودیو به گیت لب

در ابتدا باید در وب سایت Gitlab یک repository ایجاد کنیم.

خب روال ساخت پروژه در وب سایت گیت لب ساده است به این صورت که پس از وارد شدن به حساب کاربری خود می توانید درون صفحه اصلی گیت لب گزینه New Project را بزنید.

در صفحه بعد از شما نوع پروژه ای که  می خواهید ایجاد کنید را می پرسد که ما گزینه Create blank project را نیاز داریم.

گزینه هایی که گیت لب برای ساخت پروژه به ما پیشنهاد می دهد به شرح زیر است:

Create blank project: یک پروژه کاملا خالی ایجاد می کند و در ادامه شما می توانید فایل های خود را برروی این repository اضافه کنید.

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

Import Project: با استفاده از این گزینه می توانید فایل های خود را از یک سیستم دیگر مانند GitHub یا Bitbucket به گیت لب import کنید.

Run CI/CD for external repository: با استفاده از این گزینه نیز می توانید repository های خارجی خود را به Gitlab CI/CD متصل کنید.

در ادامه پس از انتخاب گزینه Create blank project ما وارد صفحه دیگری برای وارد کردن اطلاعات پروژه خواهیم شد.

اطلاعاتی که باید وارد کنید به شرح زیر است:

Project name: نام پروژه که بهتر است کلمات با خط فاصله یا dash از هم جدا شوند.

Project URL: آدرس گیت لب اکانت شما خواهد بود که البته قابل ویرایش نیست و یک داده ثابت است.

Project slug: این فیلد دقیقا همگام با زمانی که شما Project name را وارد می کنید مقدار دهی می شود به این صورت که دقیقا نام پروژه ای که وارد کرده اید با قالبی قابل قبول به خود می گیرد.

(Project description (optional: می توانید توضیحات مربوط به پروژه خود را به صورت فایل Read Me ایجاد کنید که البته این مقدار کاملا اختیاری است.

Visibility level: در این قسمت باید مشخص کنید که پروژه شما به صورت عمومی (Public) نمایش داده شود و یا خصوصی (Private)  که البته ما گزینه خصوصی را انتخاب می کنیم.

در انتها هم گزینه Initialize repository with a README را فعال می کنیم تا پروژه از همان ابتدا فایل README را دقیقا با همان مقداری که درون Project description نوشته ایم، در repository خود داشته باشیم.

و در آخر دکمه Create project را کلیک می کنیم تا پروژه ساخته شود.

پس از ساخت موفق پروژه، شما در Address bar آدرس repository خود را چیزی مانند عبارت زیر خواهید دید.

https://gitlab.com/user/sample-project

اگر به این آدرس یک پسوند git اضافه کنیم که به صورت زیر در بیاید.

https://gitlab.com/user/sample-project.git

به عبارتی این آدرس همان آدرس repository مقصد است که باید در اندروید استودیو استفاده کنید. (در ادامه آموزش از این آدرس استفاده خواهیم کرد)

حال زمان آن است که پروژه خود را از طریق اندروید استودیو به repository که ساختیم منتقل کنیم و ارتباطی بین پروژه و گیت لب ایجاد کنیم.

ایجاد ارتباط بین پروژه و گیت لب

در اندروید استودیو مطابق تصویر زیر به مسیربروید.

VCS / Import into Version Control / Create Git Repository

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

حال زمان آن است که فایل هایی که در مرحله قبل انتخاب کردید را به گیت خود Add کنید.

مراحل اضافه شدن یک فایل به گیت

مراحل اضافه شدن یک فایل به گیت به این ترتیب است Add – Commit – Push که در ادامه توضیح خواهیم داد.

همچنین بخوانید: دستورات کلیدی گیت

مرحله Add

برای Add کردن تمامی فایل هایی که انتخاب شدند تنها کافی است به مسیر زیر بروید و در پنجره باز شده دکمه ( + ) سمت چپ را بزنید تا بتوانید یک ریموت جدید با repository خود ایجاد کنید.

…VCS / Git / Remotes

سپس مطابق تصویر زیر اطلاعات را وارد کنید.

همانطور که می بینید دو مقدار باید وارد شود که مقدار اول (Name) باید حتما مقدار origin باشد که به معنای مسیر روت repository است و بهتر است آن را عوض نکنید. مقدار دوم همان مسیری repository است که ایجاد کردیم و در مراحل قبل درباره آن توضیح دادیم.

نکته:
پس وارد کردن مقادیر و کلیک دکمه Ok امکان دارد که از شما درخواست نام کاربری و رمز عبور گیت لب را بکند، که در آن صورت باید ایمیل و رمز عبور گیت لب خود را وارد کنید تا پس از اعتبار سنجی این ریموت ایجاد شود.

حال پنل سمت چپ اندروید استودیو که نمایان گر فایل های پروژه است را به حالت Project و پوشه اصلی پروژه را به حالت انتخاب در بیاورید. مانند تصویر زیر

سپس به مسیر زیر رفته و پس از کلیک گزینه Add خواهید دید پس از چند ثانیه تمامی فایل ها از رنگ قرمز به رنگ سبز در می آیند که این به معنی Add شدن موفق تمامی فایل هاست.

VCS / Git / Add

مرحله Commit

در ادامه باید فایل های Add شده را Commit کنیم، برای این کار تنها کافی است به میسر زیر برویم

VCS / Git / Commit Directory

نکته:
توجه کنید که همچنان حالت نمایش فایل ها Project باشد و پوشه اصلی پروژه به حالت انتخاب باشد.

سپس خواهید دید یک پنجره باز می شود که از این به بعد برای Commit هر فایل یا پوشه این پنجره را خواهید دید.

در این پنجره شما فایل هایی که می خواهند Commit شوند و حتی تغییرات درون فایل که باعث شده این فایل به لیست Commit ها برود را، می بینید. به علاوه می توانید یک توضیح کوتاه درباره Commit خود بنویسید (که معمولا برای Commit اول عبارت initial commit را می نویسند) و در نهایت دکمه Commit را کلیک کنید. ممکن است زمان Commit شدن پیغام خطایی مانند عکس زیر به شما نمایش داده شود.

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

چند دقیقه بعد خواهید دید تمامی فایل ها با موفقیت Commit شدند، اما هنوز به repository گیت لب انتقال پیدا نکرده اند که برای این انتقال ما باید مرحله Push را انجام دهیم.

مرحله Push

در ادامه آخرین مرحله ای که باید انجام  دهیم تا فایل های ما در Gitlab به طور کامل نمایش داده شود، Push کردن تمامی فایل هایی است که Commit شده اند.

برای Push کردن باید به مسیر زیر برویم

VCS / Git / Push

در ادامه پنجره ای برای شما باز می شود که لیست Commit هایی که می خواهند Push شوند و همچنین فایل های هر Commit ، را به شما نشان می دهد.

دکمه Push را کلیک کنید و خواهید دید Commit های شما با موفقیت بر روی repository گیت لب Push شده اند و حال تمامی فایل های شما در سایت گیت لب و در همان repository مربوطه قابل نمایش است.

در اولین Push ممکن است شما با خطای Push to origin/master was rejected مواجه شوید که معمولا فقط در اولین Push این خطا به شما نمایش داده می شود.

برای حل این خطا تنها کافی ست درون ترمینال اندروید استودیو دستور زیر را بنویسید:

git pull origin master --allow-unrelated-histories

سپس شما باید ایمیل و رمز عبور گیت لب خود را وارد کنید.

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

پس از چند ثانیه تمامی اطلاعات با موفقیت از گیت لب Pull می شود و سپس می توانید مجددا پروژه خود را Push کنید و این بار بدون خطا تمامی فایل های شما در گیت لب وجود خواهد داشت و می توانید درون repository تمامی فایل های خود با همان ساختار، ببینید.

امیدوارم این آموزش برای شما مفید بوده باشد…

کلمات کلیدی: ارسال پروژه از اندروید استودیو به گیت لب,ارسال پروژه از اندروید استودیو به GitLab,گیت لب,GitLab,ایجاد یک repository در گیت لب