شبیه‌سازی (Clone)

به طور کلی، git p4 clone برای ایجاد یک دایرکتوری گیت جدید از یک مخزن موجود p4 استفاده می‌شود:

$ git p4 clone //depot/path/project

این کار:

برای بازتولید تمام تاریخچه p4 در گیت، از تغییردهندهٔ @all در مسیر انبار استفاده کنید:

$ git p4 clone //depot/path/project@all

همگام‌سازی (Sync)

همان‌طور که توسعه در مخزن p4 ادامه می‌یابد، آن تغییرات را می‌توان با استفاده از دستور زیر در مخزن گیت گنجاند:

$ git p4 sync

این دستور تغییرات جدید را در p4 پیدا کرده و آن‌ها را به عنوان کامیت‌های گیت وارد می‌کند.

مخازن p4 را می‌توان با استفاده از git p4 sync به یک مخزن موجود گیت نیز افزود:

$ mkdir repo-git
$ cd repo-git
$ git init
$ git p4 sync //path/in/your/perforce/depot

این کار انبار مشخص‌شده را در refs/remotes/p4/master در یک مخزن موجود گیت وارد می‌کند. گزینهٔ --branch می‌تواند برای تعیین یک شاخهٔ متفاوت جهت استفاده برای محتوای p4 به کار رود.

اگر یک مخزن گیت شامل شاخه‌های refs/remotes/origin/p4 باشد، این شاخه‌ها در طول یک عملیات git p4 sync ابتدا واکشی شده و مورد ارجاع قرار می‌گیرند. از آنجا که وارد کردن مستقیم از p4 به مراتب کندتر از واکشی تغییرات از یک مخزن دوردست گیت است، این قابلیت می‌تواند در یک محیط با چند توسعه‌دهنده مفید باشد.

اگر چندین شاخه وجود داشته باشد، اجرای git p4 sync به طور خودکار از الگوریتم «تشخیص شاخه» (BRANCH DETECTION) برای تلاش جهت تفکیک تغییرات جدید به شاخه درست استفاده می‌کند. این رفتار را می‌توان با گزینهٔ --branch لغو کرد تا تنها یک شاخه برای به‌روزرسانی مشخص شود.

تغییر پایه (Rebase)

یک الگوی کاری رایج، واکشی آخرین تغییرات از انبار p4 و ادغام آن‌ها با تغییرات محلی ثبت‌نشده (uncommitted) است. اغلب اوقات، مخزن p4 مکان نهایی تمام کدها است، از این رو یک گردش کار بازنشانی پایه (rebase) منطقی به نظر می‌رسد. این دستور یک git p4 sync و به دنبال آن یک git rebase را اجرا می‌کند تا کامیت‌های محلی را به بالای تغییرات به‌روزشدهٔ p4 منتقل کند.

$ git p4 rebase

ارسال (Submit)

ارسال تغییرات از یک مخزن گیت به مخزن p4 نیازمند یک فضای کاری کلاینت (client workspace) مجزای p4 است. این مورد باید با استفاده از متغیر محیطی P4CLIENT یا متغیر پیکربندی گیت git-p4.client مشخص شود. کلاینت p4 باید وجود داشته باشد، اما اگر ریشه کلاینت (client root) هنوز وجود نداشته باشد، ایجاد شده و فایل‌ها در آن پر می‌شوند.

برای ارسال تمام تغییراتی که در شاخه فعلی گیت هستند اما در شاخهٔ p4/master نیستند، از دستور زیر استفاده کنید:

$ git p4 submit

برای مشخص کردن شاخه‌ای غیر از شاخه فعلی، از دستور زیر استفاده کنید:

$ git p4 submit topicbranch

برای مشخص کردن یک کامیت منفرد یا یک محدوده از کامیت‌ها، از دستور زیر استفاده کنید:

$ git p4 submit --commit <sha1>
$ git p4 submit --commit <sha1..sha1>

مرجع بالادستی (upstream reference) به طور کلی refs/remotes/p4/master است، اما می‌تواند با استفاده از گزینهٔ خط فرمان --origin= بازنویسی شود.

تغییرات p4 با هویت کاربری که git p4 submit را اجرا می‌کند ایجاد خواهند شد. گزینهٔ --preserve-user باعث می‌شود مالکیت با توجه به پدیدآورندهٔ (author) کامیت گیت تغییر یابد. این گزینه نیازمند دسترسی‌های مدیر در p4 است که می‌تواند با استفاده از p4 protect اعطا شود.

برای قفسه‌بندی (shelve / تعلیق موقت) تغییرات به جای ارسال، از --shelve و --update-shelve استفاده کنید:

$ git p4 submit --shelve
$ git p4 submit --update-shelve 1234 --update-shelve 2345

خروج از قفسه (Unshelve)

عملیات Unshelving یک لیست تغییرات (changelist) تعلیق‌شده در P4 را دریافت کرده و کامیت معادل گیت را در شاخهٔ refs/remotes/p4-unshelved/<changelist> تولید می‌کند.

کامیت گیت نسبت به نسخه مبدا فعلی (به طور پیش‌فرض HEAD) ایجاد می‌شود. یک کامیت والد بر اساس مبدا ایجاد شده و سپس کامیت unshelve بر اساس آن ساخته می‌شود.

نسخه مبدا را می‌توان با گزینهٔ "--origin" تغییر داد.

اگر شاخه هدف در refs/remotes/p4-unshelved از قبل وجود داشته باشد، شاخه قدیمی تغییر نام خواهد یافت.

$ git p4 sync
$ git p4 unshelve 12345
$ git show p4-unshelved/12345
<submit more changes via p4 to the same files>
$ git p4 unshelve 12345
<refuses to unshelve until git is in sync with p4 again>

گزینه‌های عمومی (General options)

همه دستورها به جز clone این گزینه‌ها را می‌پذیرند.

--git-dir <dir>

-v, --verbose

گزینه‌های همگام‌سازی (Sync options)

این گزینه‌ها را می‌توان در clone اولیه و همچنین در عملیات‌های بعدی sync استفاده کرد.

--branch <ref>

$ git init
$ git p4 sync --branch=refs/remotes/p4/proj2 //depot/proj2

--detect-branches

--changesfile <file>

--silent

--detect-labels

--import-labels

--import-local

--max-changes <n>

--changes-block-size <n>

--keep-path

--use-client-spec

-/ <path>

گزینه‌های شبیه‌سازی (Clone options)

این گزینه‌ها را می‌توان در یک clone اولیه به همراه گزینه‌های sync که در بالا توضیح داده شدند استفاده کرد.

--destination <directory>

--bare

گزینه‌های ارسال (Submit options)

این گزینه‌ها می‌توانند برای اصلاح رفتار git p4 submit استفاده شوند.

--origin <commit>

-M

--preserve-user

--export-labels

-n, --dry-run

--prepare-p4-only

--shelve

--update-shelve CHANGELIST

--conflict=(ask|skip|quit)

--branch <branch>

--commit (<sha1>|<sha1>..<sha1>)

--disable-rebase

--disable-p4sync

p4-pre-submit

قلاب p4-pre-submit در صورت وجود و قابل اجرا بودن اجرا می‌شود. این قلاب هیچ پارامتری دریافت نمی‌کند و هیچ چیزی از ورودی استاندارد نمی‌گیرد. خروج با وضعیت غیر صفر از این اسکریپت مانع از اجرای git-p4 submit می‌شود. این قلاب را می‌توان با گزینه خط فرمان --no-verify دور زد.

یک سناریوی کاربردی اجرای آزمون‌های واحد (unit tests) در این قلاب است.

p4-prepare-changelist

قلاب p4-prepare-changelist درست پس از آماده‌سازی پیام پیش‌فرض changelist و قبل از شروع ویرایشگر اجرا می‌شود. این قلاب یک پارامتر دریافت می‌کند که نام فایلی است که متن changelist را در بر دارد. خروج با وضعیت غیر صفر از اسکریپت فرآیند را متوقف خواهد کرد.

هدف از این قلاب، ویرایش درجا (in place) فایل پیام است و با گزینه --no-verify غیرفعال نمی‌شود. این قلاب حتی در صورت تنظیم --prepare-p4-only نیز فراخوانی می‌شود.

p4-changelist

قلاب p4-changelist پس از اینکه پیام changelist توسط کاربر ویرایش شد اجرا می‌شود. این قلاب می‌تواند با گزینه --no-verify دور زده شود. این قلاب یک پارامتر واحد دریافت می‌کند که نام فایلی است که متن پیشنهادی changelist را نگه‌داری می‌کند. خروج با وضعیت غیر صفر باعث لغو دستور می‌شود.

این قلاب مجاز به ویرایش فایل changelist است و می‌تواند برای یکدست‌سازی متن به قالبی استاندارد در پروژه استفاده شود. همچنین می‌تواند پس از بازبینی فایل پیام، برای رد کردن Submit استفاده شود.

p4-post-changelist

قلاب p4-post-changelist پس از اینکه ارسال با موفقیت در P4 انجام شد فراخوانی می‌شود. هیچ پارامتری دریافت نمی‌کند و اساساً برای اطلاع‌رسانی در نظر گرفته شده است و نمی‌تواند بر نتیجه عملیات git p4 submit تأثیر بگذارد.

گزینه‌های تغییر پایه (Rebase options)

این گزینه‌ها می‌توانند برای تغییر رفتار git p4 rebase استفاده شوند.

--import-labels

گزینه‌های خروج از قفسه (Unshelve options)

--origin

متغیرهای عمومی (General variables)

git-p4.user

git-p4.password

git-p4.port

git-p4.host

git-p4.client

git-p4.retries

متغیرهای شبیه‌سازی و همگام‌سازی (Clone and sync variables)

git-p4.syncFromOrigin

git-p4.branchUser

git-p4.branchList

git config       git-p4.branchList main:branchA
git config --add git-p4.branchList main:branchB

git-p4.ignoredP4Labels

git-p4.importLabels

git-p4.labelImportRegexp

git-p4.useClientSpec

git-p4.pathEncoding

git-p4.metadataDecodingStrategy

git-p4.metadataFallbackEncoding

git-p4.largeFileSystem

git config       git-p4.largeFileSystem GitLFS

git-p4.largeFileExtensions

git-p4.largeFileThreshold

git-p4.largeFileCompressedThreshold

git-p4.largeFilePush

git-p4.keepEmptyCommits

git-p4.mapUser

git config --add git-p4.mapUser "p4user = First Last <mail@address.com>"

متغیرهای ارسال (Submit variables)

git-p4.detectRenames

git-p4.detectCopies

git-p4.detectCopiesHarder

git-p4.preserveUser

git-p4.allowMissingP4Users

git-p4.skipSubmitEdit

git-p4.skipSubmitEditCheck

git-p4.allowSubmit

git-p4.skipUserNameCheck

git-p4.attemptRCSCleanup

git-p4.exportLabels

git-p4.labelExportRegexp

git-p4.conflict

git-p4.disableRebase

git-p4.disableP4Sync