تفسير صياغة CocoaPods في iOS

بعد أن تعلمت كيفية استخدام مكتبات الاعتماد الخاصة بالآخرين، ستشعر بالرغبة في إنشاء مكتبات الاعتماد الخاصة بك، اليوم سأكشف عن الغموض في عملية إنشاء مكتبات الاعتماد Pods. العملية بأكملها تستند إلى view أسمته WZMarqueeView ميزة الشاشة المتحركة، والخطوات التالية هي:

أولاً: إنشاء مخزن GitHub الخاص بك

CocoaPodsتمت إدارته على github (الرابط الرسمي هو：https://github.com/CocoaPods، وكل بنك اعتماد Pods يعتمد أيضًا على github، لذا فإن الخطوة الأولى هي إنشاء مستودع github خاص بك. واجهة إنشاء المستودع كما في الصورة التالية:

الرقم المميز في الصورة أعلاه هو 6 أماكن، والشرح التالي هو:

1. Repository name

اسم المستودع، يكتب هنا WZMarqueeView، مطلوب إدخاله؛

2. Description

معلومات وصف المستودع، اختيارية؛

3. إفتحاء المستودع

يمكن اختيار Public فقط، السبب الأول هو أن Private يتطلب المال، والسبب الثاني هو أن Private لا يمكن للآخرين رؤيته مما يعني عدم وجود مشاركة.

4. هل تريد إنشاء ملف README الافتراضي

كل مستودع كامل يحتاج إلى ملف توضيحي README، يُنصح باختياره. إذا لم تكن تزعجك الأمور، يمكنك إنشائه يدويًا لاحقًا أيضًا؛

5. هل تريد إضافة ملف .gitignore

ملف .gitignore يحتوي على أنواع عديدة من الملفات، وكل نوع ملف يحتوي عليه لن يتم تضمينه في إدارة الإصدارات الخاصة بـ git. يمكن أن يتم اختيار هذا بناءً على الحاجة الشخصية؛

6. نوع الترخيص

جميع المستودعات الرسمية يجب أن تحتوي على ملف الترخيص، والبنوك الاعتمادية Pods تتطلب هذا الملف بشكل أشد، فهو يجب أن يكون موجودًا. لذا من الأفضل ترك github إنشائه هنا، أو يمكنك إنشائه لاحقًا. النوع الذي أستخدمه هو MIT.

بعد إكمال إدخال جميع العناصر المذكورة أعلاه، انقر على زر Create repository، وسيظهر لك الشكل التالي عند نجاح الإجراء:

إلى هنا، انتهت عملية إنشاء المستودع.

ثانيًا، استنساخ المستودع المحلي
للراحة في إزالة المحتويات من المستودع، يجب أولاً نسخ المستودع المحلي، هناك عدة طرق للقيام بذلك، يُنصح باستخدام سطر الأوامر:

$ git clone https://github.com/wangzz/WZMarqueeView.git

بعد إكمال العملية، سيتم نسخ ملفات github الم对应ة إلى الخزنة المحلية، بنية الدليل هي:

ملف .gitignore في مستودع github هو ملف مخفي يبدأ بـ .، لذلك يمكن رؤية اثنين فقط هنا.
جميع إضافات الملفات وإزالتها وتعديلاتها اللاحقة ستتم في هذا الدليل.

ثالثًا، أضف ملفات إنشاء البنوك الاعتمادية Pods إلى الخزنة المحلية git

ملاحظة: يجب أن تكون جميع الملفات المذكورة أدناه في مجلد الجذر للخزنة المحلية التي تم فك تشفيرها في الخطوة الثانية.
1. ملفات نهاية .podspec
هذا الملف هو ملف الوصف للبنوك الاعتمادية Pods، يجب أن يكون لكل بنك اعتماد Pods ملف وصف واحد فقط. يجب أن يكون اسم الملف متطابقًا مع اسم البنك الاعتمادي الذي نريد إنشائه، واسم ملف بنك الاعتماد WZMarqueeView الخاص بي هو WZMarqueeView.podspec.
1.1 podspec文件内容

WZMarqueeView.podspec的保存内容为：

Pod::Spec.new do |s|
 s.name       = "WZMarqueeView"
 s.version     = "1.0.0"
 s.summary     = "A marquee view used on iOS."
 s.description   = <<-DESC
            It is a marquee view used on iOS, which implement by Objective-C.
            DESC
 s.homepage     = "https://github.com/wangzz/WZMarqueeView"
 # s.screenshots   = "www.example.com/screenshots_1", "www.example.com/screenshots_2"
 s.license     = 'MIT'
 s.author      = { "王中周" => "[email protected]" }
 s.source      = { :git => "https://github.com/wangzz/WZMarqueeView.git", :tag => s.version.to_s }
 # s.social_media_url = 'https://twitter.com/NAME'
 s.platform   = :ios, '4.3'
 # s.ios.deployment_target = '5.0'
 # s.osx.deployment_target = '10.7'
 s.requires_arc = true
 s.source_files = 'WZMarqueeView/*'
 # s.resources = 'Assets'
 # s.ios.exclude_files = 'Classes/osx'
 # s.osx.exclude_files = 'Classes/ios'
 # s.public_header_files = 'Classes/**/*.h'
 s.frameworks = 'Foundation', 'CoreGraphics', 'UIKit'
fin

هذا الملف هو ملف Ruby، ويكون كل عنصر فيه واضح المعنى.
هناك بعض المعلمات التي تحتاج إلى توضيحها:
① s.license
نوع الترخيص الذي يستخدمه مكتبة الاعتماد Pods، يمكنك تعبئة الخيار المناسب.
② s.source_files
يُشير إلى مسار ملفات المصدر، يُلاحظ أن هذا المسار هو مسار مطلق بالنسبة لملف podspec.
③ s.frameworks
البرامج التي تحتاج إلى استخدامها، لا تحتاج إلى إضافة缀 الملف .frameworks.

1.2 كيفية إنشاء ملف podspec

يمكن لكل منكم إنشاء ملف podspec الخاص بك بطرقين:
① نسخ ملف podspec الخاص بي ثم تعديل المعلمات المطلوبة، أقترح استخدام هذا الأسلوب.
② تنفيذ الأمر التالي لإنشاء الملف:

$ pod spec create WZMarqueeView

سيتم أيضًا إنشاء ملف يُدعى WZMarqueeView.podspec. ولكن عندما تفتح الملف الذي تم إنشاؤه، ستجد أن هناك الكثير من الأشياء فيه، العديد منها ليس لنا حاجة إليه.

2،ملف الترخيص LICENSE
يفرض CocoaPods أن تكون جميع مكتبات الاعتماد Pods تحتوي على ملف الترخيص، لا يتم التحقق منها إلا إذا كان ذلك كذلك. هناك أنواع عديدة من التراخيص، يمكنك الاطلاع على التفاصيل في الموقع tl;dr Legal. اخترت نوع الترخيص MIT عند إنشاء مستودع GitHub.

3،ملف الكلاس الرئيسي
تم إنشاء مكتبات الاعتماد Pods لجعل استخدام نتائجنا سهلاً للآخرين، مثل كلاس WZMarqueeView الذي أريد مشاركته مع الجميع، وهو شيء لا مفر منه. وضعت ملفي هذا الكلاس في مجلد يُدعى WZMarqueeView، والهيكل الموجه كما هو موضح في الشكل التالي:

يحتوي على ملفين: WZMarqueeView.h و WZMarqueeView.m

4،مشروع تجريبي
لإرشاد الآخرين بسرعة في استخدام مكتبات الاعتماد Pods الخاصة بنا، غالبًا ما يتطلب ذلك تقديم مشروع تجريبي. قمت بإنشاء مشروع تجريبي ووضعه في مجلد يُدعى WZMarqueeViewDemo، والذي يحتوي على الملفات كما هو موضح في الشكل التالي:

5،README.md
يجب أن يكون المستخدمون الذين يستخدمون GitHub مألوفين بهذا الملف، وهو جزء لا يتجزأ من مستودع GitHub الناجح، ويستخدم لغة التسميات البرمجية markdown، لشرح تفاصيل المستودع.

المكونات الأساسية الخمسة التي ذكرتها أعلاه هي المطلوبة لإنشاء مكتبات الاعتماد Pods، من بينها 1،2،3 مطلوبة، و4،5 اختيارية ولكن أوصي بشدة بإنشائها.
بعد إضافة هذه الملفات، أصبح مجلد المستودع المحلي على GitHub كما هو موضح في الشكل التالي:

الخطوة الرابعة، إرسال ملفات التغيير إلى GitHub
بعد الخطوة الثالثة، تم إضافة العديد من الملفات إلى مستودع git المحلي، الآن يجب رفعها إلى مستودع GitHub. عملية الرفع تتكون من الخطوات التالية:
1. التحقق من pod
قم بتفيذ الأوامر التالية:

$ قم بتعيين الإصدار الجديد إلى 1.0.0
$ قم بتعيين العلامة الجديدة إلى 1.0.0

هذان الأمران لتحديد إصدار pod وتسجيل العلامة المحددة. ثم أمر التحقق من pod:

$ pod lib lint

إذا كان كل شيء على ما يرام، فإن هذا الأمر سيظهر النتيجة التالية بعد تنفيذه:

 -> WZMarqueeView (1.0.0)
WZMarqueeView اجتاز التحقق.

إلى هنا، ينتهي عملية التحقق من pod.
يجب توضيح أن في أثناء تنفيذ أمر التحقق من pod، إذا تم إطلاق أي رسائل تحذير أو خطأ، فإن التحقق سيتمكن من الفشل! إذا ظهرت أي استثناءات أثناء التحقق، سيكون هناك معلومات مفصلة، يمكن للجميع إجراء التغييرات بناءً على الإرشادات.

2. رفع محتويات المستودع المحلي إلى مستودع GitHub
قم بتنفيذ الأوامر التالية ترتيبًا:

$ git add -A && git commit -m "Release 1.0.0"
$ git tag '1.0.0'
$ git push --tags
$ git push origin master

الأمر المذكور أعلاه ينتمي إلى فئة git، لذلك لن نذكره هنا. إذا كان كل شيء على ما يرام، يجب أن تتمكن من رؤية المحتويات التي أضفتها على GitHub. كما هو موضح في الشكل التالي:

خامسًا، رفع ملف podspec إلى مستودع CocoaPods الرسمي
بعد الخطوات الأربعة السابقة، قد تعتقد أن الأمور قد انتهت، ولكن بالرغم من ذلك، لا تزال الأمور تبدأ.

لجعل مكتبة Pods الاعتماد قابلة للاستخدام حقًا، يجب القيام بعملية إضافية واحدة، وهي تحميل ملف podspec الذي قمنا بإنشائه إلى مستودع Specs الرسمي لمكتبة CocoaPods، والرابط الخاص به هو: https://github.com/CocoaPods/Specs

بفتح هذا الرابط ستجد أن كل ما يمكننا استخدامه، بالإضافة إلى كل Pods الاعتماد التي يمكننا البحث عنها باستخدام الأمر pod search، تقوم بتحميل ملفات podspec الخاصة بها إلى هذا المستودع، مما يعني أن فقط بعد تحميل ملف podspec الخاص بنا إلى هذا المستودع يمكننا أن نصبح مكتبة Pods الاعتماد الحقيقية، يمكن للآخرين استخدامها بشكل طبيعي!

بموجب قواعد git، لصنع ملفات في مستودع شخص آخر، يجب أولاً فورك مستودع شخص آخر، بعد إجراء التغييرات اللازمة، ثم قم بإرسالها إلى صاحب المستودع الأصلي، بعد مراجعة المؤلف وتوافقهم، ثم دمجها في المستودع الأصلي.

بعد فهم العملية، ستعرف كيفية العمل بشكل طبيعي:
1، قم بـ fork لمخزن CocoaPods الرسمي Specs
دخول إلى رابط المخزن الرسمي، انقر على زر fork في الزاوية العلوية اليمنى من الشاشة، كما هو موضح في الصورة التالية:

ثم ستجد أن لديك فرعًا جديدًا تحت اسمك. على سبيل المثال، فرعي هو:

2، قم بت克隆 مخزن fork إلى المحلي
قم بتفيذ الأوامر التالية:

$ git clone https://github.com/wangzz/Specs.git

لاحظ، يجب على الجميع استبدال عنوان URL للمخزن الخاص بك.
هذا المخزن كبير، ويحتاج إلى صبر.

3، أضف ملف podspec الخاص بك إلى مخزن Specs المحلي
بعد ت克隆 مخزن Specs إلى المحلي، سيتم وضعه في مجلد يحمل الاسم Specs. المبدأ لتحفظ ملفات podspec في مخزن Specs هو:
مجلدات الاعتماد على Pods بنفس الاسم -> مجلدات إصدار بنفس الاسم -> ملف podspec
بالمعنى نفسه، يجب أن أقوم بإنشاء دليل WZMarqueeView في دليل Specs، ثم الدخول إلى دليل WZMarqueeView، إنشاء دليل يحمل الاسم 1.0.0، وأخيرًا الدخول إلى دليل 1.0.0، ثم نسخ ملف WZMarqueeView.podspec الذي تم إنشاؤه مسبقًا إلى هذا الدليل.
من السهل الفهم، إذا كان هناك أي تحديثات على فئة WZMarqueeView في المستقبل، قم بإنشاء دليل يحمل اسم إصدار الفئة في دليل WZMarqueeView، لتح Konserv podspec الملفات.
بعد إكمال هذه العمليات، سيكون بنية الدليل كما يلي:

4، قم برفع التعديلات الموجودة في مخزن Specs المحلي إلى مخزن GitHub.
قم بتفيذ الأوامر التالية:

$ git add -A && git commit -m "إضافة ملف WZMarqueeView podspec"
$ git push origin master

بعد الانتهاء بنجاح، يمكنك رؤية الملفات التي تم رفعها حديثًا في مخزن Specs الخاص بك على GitHub.

5، ستحتاج إلى سحب التعديلات التي قمت بها على Specs التي قمت بـ fork إلى مخزن Specs الرسمي لمكتبة CocoaPods.
بمجرد الدخول إلى مخزن Specs الذي قمت بـ fork، سترى زر أخضر في الزاوية العلوية اليسرى من الشاشة:

بعد الضغط على الزر، سيظهر لك الشاشة كما هو موضح في الصورة التالية:

انقر على زر Create Pull Request الأخضر في الصورة، وسيمكنك سحب التعديلات التي قمت بها على Specs التي نقوم بـ fork إلى مخزن Specs الرسمي لمكتبة CocoaPods.

بعد هذا، العمل المتبقي هو فقط الانتظار، انتظار مراجعة مسؤولي CocoaPods والدمج التغييرات التي قمنا بجذبها إلى مخزن Specs الرسمي، وغالبًا ما يستغرق هذا العمل يومًا تقريبًا. إذا كان هناك أي رسائل، مثل رفض التدقيق، أو قبوله، سيتم إرسال بريد إلكتروني من CocoaPods الرسمي.
بمجرد أن يتم التدقيق، سنتمكن من رؤية المجلد الذي قمنا بنفسي بتحميله في مخزن Specs الرسمي.

الشهر السادس، مراقبة تقدم التدقيق
بالطبع، يمكننا أيضًا مراقبة تقدم التدقيق، افتح هذا الرابط:https://github.com/CocoaPods/Specs/pulls، يمكنك رؤية جميع طلبات pull الخاصة بـ Specs المخزن، كما في الشكل التالي:

النقطة الحمراء المحددة هي الطلب الذي قمت بجذبه للتو، بعد النقر عليها يمكنك رؤية تقدم التدقيق.

السادس، عرض مكتبات الاعتماد الخاصة بنا
إذا استلمت بريدًا من CocoaPods الرسمي يفيد بقبول التدقيق، قد تكون متحمسًا للتنفيذ أوامر pod search على جهازك الخاص لمعرفة ما إذا كان يمكنك البحث عن مكتبات الاعتماد الخاصة بك. ولكن ستفشل بالتأكيد، لأنه يجب تنفيذ أوامر أخرى قبل أن نتمكن من استخدام أوامر البحث في جهازنا المحلي:

$ pod setup

في المقالة الأولى من سلسلة تعليمات CocoaPods الخاصة بي: الجزء الأخير من المقالة المتقدمة حول تفاصيل CocoaPods، تم تقديم هذه الأوامر، حيث سيتم تحديث جميع مكتبات الاعتماد الخاصة بـ Pods إلى الشجرة المحلية. بعد تنفيذ هذه الأوامر، قم بتنفيذ:

$ pod search WZMarqueeView

سيتم عرض معلومات التدليل المناسبة!

بعد كل هذا، يُعتبر عملية إنشاء مكتبات الاعتماد الخاصة بـ Pods قد إنتهت بالفعل! يا أصدقاء، هل نجحت؟ هل واجهت أي مشاكل؟ يرجى ترك تعليق.

السابعًا، الوثائق المرجعية

1ًاhttp://guides.cocoapods.org