أداة إكسكود: كشف في جت هوب
هذا هو README.md من مشروع GitHub https://github.com/lzwjava/Reveal-In-GitHub.
Reveal-In-GitHub
منبر اكسكود مصمم لتحسين التنقل السلس إلى الوظائف الرئيسية لموقع GitHub داخل مستودعك الحالي. بالضغط على زر واحد، يمكنك الوصول بسهولة إلى سجلات GitHub، التهمية، طلبات سحب، المسائل، والإشعارات، وكل ذلك في غضون ثوان.
شركة العمل هنا تعمل على GitHub. افتتاح موقع GitHub كثيرا. أحيانا، أنا أحرر في Xcode ولا أفهم بعض الكود، فإذا ذهبت إلى GitHub للتفريق. وأحيانًا، العثور على الإلتقاطات أحدث عن ملف ما لمساعدتي في فهم كيفية تطور الكود. لذلك سأسأل هل هناك أداة تساعدني في فتح GitHub من Xcode بسرعة. كتبت هذا المنبر. أثناء تحرير بعض ملفات المصدر في Xcode، على السهولة معرفة أي مستودع GitHub أنت تعمل عليه وأيّ ملف أنت تحريره. لذلك، من المنطقي الانتقال إلى الملف على GitHub بسرعة، الانتقال إلى التهمية لسلسلات الكود الحالية على GitHub بسرعة، الانتقال إلى المسائل أو طلبات سحب للمستودع الحالي الذي تعمل عليه في Xcode بسرعة.
عناصر القائمة
يحتوي على ستة عناصر القائمة:
Menu Title | Shortcut | GitHub URL Pattern (عندما كنت أدخل LZAlbumManager.m السطر 40) | —————-|———————–|———————————-
| Setting | ⌃⇧⌘S | |
| Repo | ⌃⇧⌘R | https://github.com/lzwjava/LZAlbum |
| Issues | ⌃⇧⌘I | https://github.com/lzwjava/LZAlbum/issues |
| PRs | ⌃⇧⌘P | https://github.com/lzwjava/LZAlbum/pulls |
| Quick File | ⌃⇧⌘Q | https://github.com/lzwjava/LZAlbum/blob/fd7224/LZAlbum/manager/LZAlbumManager.m#L40 |
| List History | ⌃⇧⌘L | https://github.com/lzwjava/LZAlbum/commits/fd7224/LZAlbum/manager/LZAlbumManager.m |
| Blame | ⌃⇧⌘B | https://github.com/lzwjava/LZAlbum/blame/fd7224/LZAlbum/manager/LZAlbumManager.m#L40 |
| Notifications | ⌃⇧⌘N | https://github.com/leancloud/LZAlbum/notifications?all=1 |
الاختصارات مصممة بعناية. لن تكون في تناقض مع اختصارات Xcode الافتراضية. نضارة الإختصارات هي ⌃⇧⌘ (Ctrl+Shift+Command)، بالإضافة إلى أول حرف من عنوان القائمة.
تعديل
أحيانًا، قد ترغب في الانتقال بسرعة إلى Wiki. هذا هو الطريق، افتح الإعداد:
على سبيل المثال،
مفتاح السريع، النموذج والحلقة الفعلي:
{git_remote_url} /blob/{commit}/ {file_path} #{selection}
https://github.com/lzwjava/LZAlbum/blob/fd7224/LZAlbum/manager/LZAlbumManager.m#L40-L43
{commit} هو تسلسل التجميع الأخير للمفرع الحالي. يكون أكثر من استخدام الفروع. لأنه قد تغير رأس الفرع. لذلك قد تغير الكود في #L40-L43 أيضًا.
إذا كنت تريد إضافة اختصار إلى Wiki للمستودع الحالي، فقط أضف عنصر قائمة ووضع النموذج إلى {git_remote_url}/wiki.
في الإعدادات، “Clear Default Repos” إذا كان لديك عدة مستودعات Git. عند التفعيل لأول مرة، سيطلب منك اختيار واحد منهم:
ثم يغسل المنبر ما اخترته. لذلك، عندما تفعّل القائمة مرة أخرى، ستفتح تلك المستودع البعيدة كإعداد افتراضي. زر “Clear Default Repos” سيضيء هذا الإعداد وسيطلب منك اختيار مرة أخرى.
التثبيت
يوصى بالتثبيت مع Alcatraz,
أو
- استنساخ هذا المستودع.
- افتح
Reveal-In-GitHub.xcodeproj، وابنيه. - يجب أن يكون
Reveal-In-GitHub.xcpluginفي~/Library/Application Support/Developer/Shared/Xcode/Plug-ins - اعادة تشغيل Xcode
- افتح أي مشروع GitHub واضغط على ⌃⇧⌘B (Ctrl+Shift+Command+B) لتهمية الكود.
التثبيت
نوصي باستخدام Alcatraz، يمكنك الاستعارة من مقالات. بعد التثبيت، تبعا للصور أعلاه، ابحث عن Reveal In GitHub واضغط على زر Install.
إذا لم تستخدم هذه الأداة، فكلا أحد هذه الخطوات:
- استنساخ هذا المشروع إلى جهازك المحلي.
- افتح xcodeproj، واضغط على Build لابناء. هذا سيخلق ملف
Reveal-In-GitHub.xcpluginفي الدليل~/Library/Application Support/Developer/Shared/Xcode/Plug-ins. - اعادة تشغيل Xcode، افتح أي مستودع GitHub. اضغط على
Ctrl+Shift+Command+Bلتهمية الكود.
الاعتراف
عند تطويره، وجدت منبر آخر ShowInGitHub يفعل شيئا متشابه. تعلمت منه بعض التقنيات. شكرًا لذلك.
الرخصة
MIT