थोस: iOS स्प्रिंगबोर्ड के लिए एक ट्वीक लिखना

प्रिय हैबर लोगों को नए साल की शुभकामनाएँ!

आज मैं थियोस का उपयोग करके आईओएस स्प्रिंगबोर्ड के लिए एक ट्वीक बनाने के बारे में बात करूंगा । क्यों? एक दिलचस्प ड्राइंग और प्रशिक्षण के रूप में। ट्यूटोरियल के अंत में, हमें अपने आई-डिवाइस की लॉक स्क्रीन पर कुछ इस तरह मिलता है:

एक परियोजना बनाना और थियोस की स्थापना करना

हम शुरू करते हैं: हम एक खाली फ़ोल्डर बनाते हैं, हम इसे में फेंक देते हैं (मैंने इसे गिग सबमॉड्यूल के रूप में फेंक दिया)।

अगला, एनआईसी का उपयोग करके एक नया प्रोजेक्ट बनाएं:

iHabrTweak git:(master) theos/bin/nic.pl NIC 2.0 - New Instance Creator ------------------------------ [1.] iphone/application [2.] iphone/library [3.] iphone/preference_bundle [4.] iphone/tool [5.] iphone/tweak Choose a Template (required): 5 Project Name (required): iHabrTweak Package Name [com.yourcompany.ihabrtweak]: com.silvansky.ihabr Author/Maintainer Name [Valentine Silvansky]: silvansky [iphone/tweak] MobileSubstrate Bundle filter [com.apple.springboard]: Instantiating iphone/tweak in ihabrtweak/... Done. 

अब हमारे पास ihabrtweak फ़ोल्डर है, जिसमें वे फाइलें हैं जिनकी हमें आवश्यकता है।

 iHabrTweak git:(master) ✗ cd ihabrtweak ihabrtweak git:(master) ✗ ls Makefile Tweak.xm control iHabrTweak.plist theos 

अब रन बनाएं और त्रुटियां देखें: यह इतना आसान नहीं है! हमारा सिस्टम थोस पर परीक्षण के लिए पूरी तरह से तैयार नहीं है।

ठीक है, आपको सामान्य विधानसभा के लिए आवश्यक सेटिंग्स दर्ज करने की आवश्यकता है:

 export ARCHS=armv7 export TARGET=iphone:latest:4.3 export THEOS="`pwd`/theos" export SDKVERSION=6.0 export THEOS_DEVICE_IP=192.168.2.2 

ARCHS हमें ARCHS है कि हम केवल armv7 के लिए इकट्ठा करेंगे, और armv6 पर हम मार डालेंगे। TARGET हमें बताता है कि हम iOS के लिए नवीनतम (सिस्टम में) SDK का उपयोग करके और संस्करण 4.3 के साथ संगतता के साथ एकत्र करेंगे। शेष तीन स्व-स्पष्ट हैं।

 ihabrtweak git:(master) ✗ make Making all for tweak iHabrTweak... Preprocessing Tweak.xm... Compiling Tweak.xm... Linking tweak iHabrTweak... Stripping iHabrTweak... Signing iHabrTweak... ihabrtweak git:(master) ✗ ls .theos/obj Tweak.xm.o iHabrTweak.dylib 

अब हमारे पास हमारी अद्भुत गतिशील लाइब्रेरी है, जो अब तक कुछ भी करना नहीं जानता है! लेकिन हम डिवाइस पर अपना ट्विस्ट इंस्टॉल कर सकते हैं:

 ihabrtweak git:(master) ✗ make package Making all for tweak iHabrTweak... make[2]: Nothing to be done for `internal-library-compile'. Making stage for tweak iHabrTweak... dpkg-deb: building package `com.silvansky.ihabr' in `./com.silvansky.ihabr_0.0.1-1_iphoneos-arm.deb'. ihabrtweak git:(master) ✗ make package install Making all for tweak iHabrTweak... make[2]: Nothing to be done for `internal-library-compile'. Making stage for tweak iHabrTweak... dpkg-deb: building package `com.silvansky.ihabr' in `./com.silvansky.ihabr_0.0.1-2_iphoneos-arm.deb'. install.copyFile "./com.silvansky.ihabr_0.0.1-2_iphoneos-arm.deb" "com.silvansky.ihabr_0.0.1-2_iphoneos-arm.deb" root@192.168.2.2's password: com.silvansky.ihabr_0.0.1-2_iphoneos-arm.deb 100% 1454 1.4KB/s 00:00 install.exec "dpkg -i com.silvansky.ihabr_0.0.1-2_iphoneos-arm.deb" root@192.168.2.2's password: Selecting previously deselected package com.silvansky.ihabr. (Reading database ... 2516 files and directories currently installed.) Unpacking com.silvansky.ihabr (from com.silvansky.ihabr_0.0.1-2_iphoneos-arm.deb) ... Setting up com.silvansky.ihabr (0.0.1-2) ... install.exec "timeout 10s sbreload || ( ( respring || killall -9 SpringBoard ) && launchctl load /System/Library/LaunchDaemons/com.apple.SpringBoard.plist )" root@192.168.2.2's password: launchctl unload SpringBoard.plist waiting for kill(29) != 0... 

दरअसल, ट्वीक तैयार है! यह सेट है, लेकिन कुछ भी नहीं करता है। हम इस पर राज करेंगे। चलो थियोस के सिद्धांत और उसकी बातों के साथ शुरू करते हैं।
जैसा कि आप पहले ही देख चुके हैं, परियोजना में हमारे पास Tweak.xm फ़ाइल है, जो हमारा मुख्य स्रोत है।

फिलहाल, इसमें सब कुछ टिप्पणी की गई है, और टिप्पणी स्वयं एक आंशिक दस्तावेज है। दरअसल, यह फ़ाइल अंतिम .mm फ़ाइल बनाने के लिए एक टेम्प्लेट है। इस टेम्प्लेट के कुछ उपयोगी मैक्रो पर विचार करें:

% हुक और% अंत

थोस ट्विक्स हुक पर आधारित हैं। वे ऑब्जेक्टिव-सी भाषा के सबसे अमीर रनटाइम पर आधारित हैं, जो एक मनमाना वर्ग में विधियों के प्रतिस्थापन की अनुमति देता है। वास्तव में, इसका उपयोग इस तरह किया जाता है:

 %hook SomeClass -(void)someMethod { // some code goes here } %end 

यहाँ हम "SomeClass" वर्ग के "someMethod" विधि का परिचय (प्रतिस्थापित) करते हैं। उदाहरण के लिए, हम अपने कोड को स्प्रिंगबोर्ड में एम्बेड कर सकते हैं, उदाहरण के लिए, हम लॉक स्क्रीन पर अपने विचार जोड़ सकते हैं।

% मूल और% नया

ठीक है, हमने विधि को फिर से परिभाषित किया, लेकिन मूल को कैसे कॉल किया जाए? हाँ, बहुत सरल भी! इसके लिए% मूल मैक्रो है। मापदंडों के बिना बुलाया जा रहा है, यह मैक्रो मूल फ़ंक्शन पर उसी तरह रीडायरेक्ट करता है जैसे यह हमारे हुक पर आया था। लेकिन आप अपनी मर्जी से पास कर सकते हैं:

 %hook SomeClass - (id)initWithFrame:(CGRect)frame { id result = %orig; // some custom code return result; } - (id)initWithName:(NSString *)name { id result = %orig(@"customName"); // some custom code return result; } %end 

यदि हुक के अंदर सरल विधि परिभाषाएं मौजूदा लोगों को ओवरराइड करती हैं, तो नए तरीकों को जोड़ने के लिए% नए मैक्रो का उपयोग किया जा सकता है। वास्तव में, यह उन विधियों के बीच एक विभाजक है जिन्हें हम प्रतिस्थापित करते हैं और उन विधियों को जोड़ते हैं जिन्हें हम जोड़ते हैं। % नए के बाद आने वाले सभी तरीकों को बिल्कुल जोड़ा जाएगा। एक उदाहरण:

 %hook SomeClass - (void)someOldMethod { // some code here } %new - (void)someNewMethod { // some more code here } %end 

लेकिन इस दृष्टिकोण के साथ, हम अपने नए तरीके को ओवरराइड एक से कॉल नहीं कर पाएंगे: थियोस वर्निंग्स को त्रुटियों के रूप में मानता है और परियोजना को इकट्ठा होने से रोकता है। आखिरकार, हमने अपनी पद्धति की घोषणा नहीं की है! लेकिन यह ठीक करने योग्य है, बस इसे हमारी फ़ाइल में जोड़ें:

 @interface SomeClass(NewMethods) - (void)someNewMethod; @end; 

% लॉग

% लॉग मैक्रो आपको सिस्टम लॉग में फ़ंक्शन कॉल के तथ्य को लिखने की अनुमति देता है। आमतौर पर डिबगिंग के लिए उपयोग किया जाता है।

अन्य मैक्रोज़ यहां देखे जा सकते हैं ।

कुछ उपयोगी लिखना

थोस के लिए सेट में, हमें सिस्टम फ्रेमवर्क के हेडर मिलते हैं। हमारी परियोजना में, वे theos/include । यदि वे झूठ नहीं बोलते हैं, तो ऐसा करना न भूलें:

 cd theos git submodule init git submodule update 

वहाँ हम स्प्रिंगबोर्ड फ़ोल्डर पाते हैं, और इसमें हेडर का एक गुच्छा होता है। ठीक है, चलो कक्षा के नामों के माध्यम से चलते हैं। चलो एक दिलचस्प SBAwayView क्लास लेते हैं, जो लॉक स्क्रीन का मुख्य दृश्य है। खैर, हम इसमें हुक लगाएंगे। पहले आपको इसके निर्माण के क्षण को पकड़ने की जरूरत है:

 #import <SpringBoard/SBAwayView.h> #import <UIKit/UIKit.h> %hook SBAwayView -(id)initWithFrame:(CGRect)frame { id result = %orig; if (result) { // here goes the code... } return result; } %end 

हम% लॉग डाल सकते हैं और विधानसभा-स्थापना के बाद सुनिश्चित कर सकते हैं कि यह विधि वास्तव में कहा जाता है। अब हम नए विचार जोड़ सकते हैं! बस कहाँ है? आइए उन्हें पृष्ठभूमि छवि में जोड़ें। हम UIImageView *_backgroundView वर्ग UIImageView *_backgroundView ivar UIImageView *_backgroundView पाते हैं, जिसमें से SBAwayView विरासत में मिला है, हम -(CGRect)middleFrame; विधि पाते हैं -(CGRect)middleFrame; । लेकिन हम आइवर मूल्य कैसे प्राप्त करते हैं? यह गूगल। आइए MSHookIvar फ़ंक्शन को खोजें, जो सब कुछ करेगा:

 #import <SpringBoard/SBAwayView.h> #import <UIKit/UIKit.h> #import <substrate.h> %hook SBAwayView -(id)initWithFrame:(CGRect)frame { id result = %orig; if (result) { CGRect labelRect = [self middleFrame]; labelRect.origin.y = labelRect.origin.y + 20.f; labelRect.size.height = 50.f; UILabel *habrLabel = [[[UILabel alloc] initWithFrame:labelRect] autorelease]; habrLabel.text = @"Hello, Habr!"; habrLabel.textColor = [UIColor colorWithRed:155.f/255.f green:182.f/255.f blue:206.f/255.f alpha:1.f]; habrLabel.opaque = NO; habrLabel.textAlignment = UITextAlignmentCenter; habrLabel.font = [UIFont boldSystemFontOfSize:36]; habrLabel.backgroundColor = [UIColor clearColor]; UIImageView *backgroundView = MSHookIvar<UIImageView *>(self, "_backgroundView"); [backgroundView addSubview:habrLabel]; } return result; } %end 

हम लॉन्च करते हैं और दृष्टि का आनंद लेते हैं!

अब कार्य को जटिल करते हैं। हम एक तस्वीर अपलोड करेंगे! सिद्धांत रूप में, सब कुछ सरल है: UILabel के बजाय, UIImageView बनाएं। और चित्र कहाँ से आता है?

छवि को स्प्रिंगबोर्ड.ऐप बंडल में रखा जाना चाहिए, और यह बेहतर है कि पैकेज की स्थापना के दौरान चित्र को वहां कॉपी किया जाए। ऐसा करने के लिए, हम प्रोजेक्ट संरचना को पुनर्गठित करेंगे: लेआउट फ़ोल्डर बनाएँ, इसमें DEBIAN फ़ोल्डर, जहाँ हम मौजूदा नियंत्रण फ़ाइल ले जाएँगे, DEBIAN फ़ोल्डर के आगे हम सिस्टम / लाइब्रेरी / कोरसेर्विस / स्प्रिंगबॉयर-टैप करेंगे, जहाँ हम अपना चित्र लगाएँगे:

 SpringBoard.app git:(master) pwd /Users/silvansky/Projects/iHabrTweak/ihabrtweak/Layout/System/Library/CoreServices/SpringBoard.app SpringBoard.app git:(master) ls habr_logo_hat.png 

अब आप अंतिम नववर्ष कोड लिख सकते हैं:

 #import <SpringBoard/SBAwayView.h> #import <UIKit/UIKit.h> #import <substrate.h> #define IMG_WIDTH 150.f #define IMG_HEIGHT 186.f %hook SBAwayView -(id)initWithFrame:(CGRect)frame { id result = %orig; if (result) { CGRect imageRect = [self middleFrame]; imageRect.origin.y = imageRect.origin.y + 20.f; imageRect.origin.x = (imageRect.size.width - IMG_WIDTH) / 2.f; imageRect.size.width = IMG_WIDTH; imageRect.size.height = IMG_HEIGHT; UIImageView *habrLogoView = [[[UIImageView alloc] initWithFrame:imageRect] autorelease]; habrLogoView.image = [UIImage imageNamed:@"habr_logo_hat"]; UIImageView *backgroundView = MSHookIvar<UIImageView *>(self, "_backgroundView"); [backgroundView addSubview:habrLogoView]; } return result; } %end 

और - हम परिणामी सुंदरता की प्रशंसा करते हैं:


पूर्ण स्रोत, हमेशा की तरह, एक गीथूब पर ले लो।

आने के साथ सभी! अगले साल खुशी और शुभकामनाएँ! =)