OS X के लिए क्विक लुक प्लगइन विकसित करना

क्विक लुक OS X में एक एप्लिकेशन है जो थंबनेल (आइकन) और प्रीव्यू बनाता है (फाइंडर में स्पेस बार दबाकर फाइल का विवरण / सामग्री के साथ एक विंडो)। यह कई मानक फ़ाइलों का समर्थन करता है, उन लोगों के लिए जो समर्थित नहीं हैं, आप क्यूएल प्लगइन्स - आइकन जनरेटर और / या पूर्वावलोकन स्थापित कर सकते हैं। उनके पास प्रारूप .qlgenerator , ~/Library/QuickLook और /Library/QuickLook .qlgenerator में रखा गया है।

मैं iOS के तहत, कभी-कभी OSX के तहत एप्लिकेशन लिखता हूं। जब मैंने पहली बार .mobileprovision - प्रोविजनिंग के लिए प्लग-इन देखा, तो मैं थर्ड-पार्टी क्विकलीक जेनरेटर पर आया था।
.mobileprovision/.provisionprofile - एक प्रोफाइल जिसमें डिवाइस इंस्टालेशन के लिए मंजूरी दी गई है, आईओएस और ओएसएक्स एप्लिकेशन को तैनात करने के लिए कुछ पैरामीटर।

इस तरह से प्रोफ़ाइल फ़ोल्डर बिना किसी क्विक लुक प्लग-इन के दिखता है:

किसी प्रोफ़ाइल का सीधे चयन करना आवश्यक है, उदाहरण के लिए, जब स्क्रिप्ट में इसका उपयोग करके स्वचालित रूप से TestFlight का उपयोग करके एप्लिकेशन को तैनात किया जाए। यह समझना कि कौन सा एप्लिकेशन किस प्रोफाइल को लेना पूरी तरह से असंभव है।

सबसे पहले, मैंने ओपन-सोर्स प्रोविजनिंग का उपयोग करना शुरू किया, फिर बंद कर दिया, लेकिन अधिक सुंदर और विस्तृत ipaql । IPaql के लेखक ने सिस्टम जारी होने के छह महीने बाद ही OS X Mavericks के साथ संगतता जोड़ने के बाद एक खुला समाधान लिखने की आवश्यकता पैदा की, और अभी तक आइकन का प्रदर्शन तय नहीं किया गया है।

यहाँ मुझे क्या मिला है - प्रावधान ।
आइकन और पूर्वावलोकन बनाने के लिए समर्थित फ़ाइल प्रकार:

• .ipa - iOS पैक किए गए एप्लिकेशन (दोनों Xcode और AppStore से)
• .app - iOS एप्लिकेशन बंडल
• .mobileprovision - iOS प्रोविज़निंग प्रोफाइल
• .provisionprofile - OSX प्रोविज़निंग प्रोफाइल

कैट के तहत, मैं त्वरित लुक प्लगइन्स बनाते समय मूल चरणों के बारे में बात करूंगा।

प्रोजेक्ट सेटअप

Xcode में, एक नया प्रोजेक्ट बनाएं: फ़ाइल> नया> प्रोजेक्ट ... OS X> सिस्टम प्लग-इन> क्विक लुक प्लग-इन। बुनियादी टेम्पलेट में, सीधे Info.plist को संपादित करने के लिए चलते हैं:

CFBundleDocumentTypes का विस्तार करें और LSItemContentTypes सरणी में वांछित फ़ाइल प्रकार जोड़ें। सूचियों और तालिकाओं में आइकन उत्पन्न करने के लिए, मैंने QLThumbnailMinimumSize को 17 से 16 में बदल दिया। QLPreviewHeight और QLPreviewWidth पर ध्यान दें - इनका उपयोग केवल तभी किया जाता है जब जनरेटर बहुत लंबे समय तक पूर्वावलोकन करता है। आईपीए के मामले में, मुझे जिप आर्काइव से कई फाइलें निकालने की जरूरत है, जो काफी लंबा समय है (0.06 से 0.12 सेकेंड तक) - मेरे मामले में सिस्टम प्लिस्ट से मूल्यों का उपयोग करता है। यदि आपका जनरेटर जल्दी से पूर्वावलोकन देता है, तो सिस्टम उस छवि या HTML से विंडो का आकार बदल देगा जो आप देंगे।

इसके अलावा, यदि आप obj-c और Foundation वर्ग पसंद करते हैं, तो GenerateThumbnailForURL.c GeneratePreviewForURL.c को GenerateThumbnailForURL.m GeneratePreviewForURL.m का नाम बदलने के लिए स्वतंत्र महसूस करें GenerateThumbnailForURL.m GeneratePreviewForURL.m अपने हेडर में जोड़ें:

 #import <Foundation/Foundation.h> #import <Cocoa/Cocoa.h> 

क्योंकि मुझे दोनों आइकन (GenerateThumbnailForURL) और एक पूर्वावलोकन विंडो (GeneratePreviewForURL) उत्पन्न करने की आवश्यकता है - मैंने Shared.h / m में सामान्य शामिल / आयात और फ़ंक्शन को हाइलाइट किया। मैं अपना Shared.h लाता हूं:

 #include <CoreFoundation/CoreFoundation.h> #include <CoreServices/CoreServices.h> #include <QuickLook/QuickLook.h> #import <Foundation/Foundation.h> #import <Cocoa/Cocoa.h> #import <Security/Security.h> #import <NSBezierPath+IOS7RoundedRect.h> static NSString * const kPluginBundleId = @"com.FerretSyndicate.ProvisionQL"; static NSString * const kDataType_ipa = @"com.apple.itunes.ipa"; static NSString * const kDataType_app = @"com.apple.application-bundle"; static NSString * const kDataType_ios_provision = @"com.apple.mobileprovision"; static NSString * const kDataType_ios_provision_old = @"com.apple.iphone.mobileprovision"; static NSString * const kDataType_osx_provision = @"com.apple.provisionprofile"; #define SIGNED_CODE 0 NSImage *roundCorners(NSImage *image); NSImage *imageFromApp(NSURL *URL, NSString *dataType, NSString *fileName); NSString *mainIconNameForApp(NSDictionary *appPropertyList); int expirationStatus(NSDate *date, NSCalendar *calendar); 

प्रोवोसिंकल प्रोजेक्ट की अंतिम संरचना:


NSBezierPath + IOS7RoundedRect - एक वर्ग से iOS7 गोल आइकन काटने के लिए कार्य करता है।
Install.sh - प्रोजेक्ट बनाते समय जनरेटर की स्वचालित स्थापना के लिए स्क्रिप्ट:

 #!/bin/sh PRODUCT="${PRODUCT_NAME}.qlgenerator" QL_PATH=~/Library/QuickLook/ rm -rf "$QL_PATH/$PRODUCT" test -d "$QL_PATH" || mkdir -p "$QL_PATH" && cp -R "$BUILT_PRODUCTS_DIR/$PRODUCT" "$QL_PATH" qlmanage -r echo "$PRODUCT installed in $QL_PATH" 

इसे निष्पादित करने के लिए, लक्ष्य सेटिंग्स पर जाएं, संपादक का चयन करें> निर्माण चरण जोड़ें> मेनू से रन स्क्रिप्ट बिल्ड चरण जोड़ें और प्रोजेक्ट फ़ोल्डर में स्क्रिप्ट का पथ दर्ज करें:


आपको प्लगइन को डीबग करना भी पड़ सकता है। क्योंकि यह अपने आप में एक निष्पादन योग्य फ़ाइल नहीं है - आपको परियोजना योजना सेटिंग्स पर जाने की आवश्यकता है - योजना संपादित करें ...> रन> जानकारी> निष्पादन योग्य> अन्य> Cmd + Shft + G> / usr / bin /> Go> qlmanage दबाएं।


फिर, तर्क टैब में, आरंभिक तर्कों में -t झंडा (डिबगिंग आइकन के लिए) या -p (डिबगिंग पूर्वावलोकन के लिए) निर्दिष्ट करें और फिर परीक्षण फ़ाइल के लिए पूर्ण पथ (मेरे मामले में, मैं .ipa पर आइकन रेंडर का परीक्षण कर रहा हूं:

आइकन जनरेशन

इस उदाहरण में, मैं दिखाऊंगा कि पहले से तैयार आइकन ( defaultIcon.png ) को कैसे प्रदर्शित किया जाए । प्रोविएनसीएल आईपीए फाइल से आइकन चयन को लागू करता है, साथ ही उपकरणों की संख्या और प्रावधान के लिए कार्रवाई की स्थिति (समाप्त या नहीं) को प्रदर्शित करता है।

यहाँ समाप्त GenerateThumbnailForURL.m :

 #import "Shared.h" OSStatus GenerateThumbnailForURL(void *thisInterface, QLThumbnailRequestRef thumbnail, CFURLRef url, CFStringRef contentTypeUTI, CFDictionaryRef options, CGSize maxSize); void CancelThumbnailGeneration(void *thisInterface, QLThumbnailRequestRef thumbnail); /* ----------------------------------------------------------------------------- Generate a thumbnail for file This function's job is to create thumbnail for designated file as fast as possible ----------------------------------------------------------------------------- */ OSStatus GenerateThumbnailForURL(void *thisInterface, QLThumbnailRequestRef thumbnail, CFURLRef url, CFStringRef contentTypeUTI, CFDictionaryRef options, CGSize maxSize) { @autoreleasepool { NSString *dataType = (__bridge NSString *)contentTypeUTI; NSImage *appIcon; if([dataType isEqualToString:kDataType_app] || [dataType isEqualToString:kDataType_ipa]) { NSURL *iconURL = [[NSBundle bundleWithIdentifier:kPluginBundleId] URLForResource:@"defaultIcon" withExtension:@"png"]; appIcon = [[NSImage alloc] initWithContentsOfURL:iconURL]; } else { return noErr; } if (QLThumbnailRequestIsCancelled(thumbnail)) { return noErr; } NSSize canvasSize = appIcon.size; NSRect renderRect = NSMakeRect(0.0, 0.0, appIcon.size.width, appIcon.size.height); CGContextRef _context = QLThumbnailRequestCreateContext(thumbnail, canvasSize, false, NULL); if (_context) { NSGraphicsContext* _graphicsContext = [NSGraphicsContext graphicsContextWithGraphicsPort:(void *)_context flipped:NO]; [NSGraphicsContext setCurrentContext:_graphicsContext]; [appIcon drawInRect:renderRect]; //draw anything you want here QLThumbnailRequestFlushContext(thumbnail, _context); CFRelease(_context); } } return noErr; } void CancelThumbnailGeneration(void *thisInterface, QLThumbnailRequestRef thumbnail) { // Implement only if supported } 

कुछ बिंदुओं पर ध्यान दिया जाना चाहिए:

• आप NSImage imageNamed: उपयोग नहीं कर सकते हैं NSImage imageNamed: - यह विधि qlmanage बंडल (निष्पादन योग्य फ़ाइल) में एक संसाधन की तलाश करेगी, और हमारे प्लगइन नहीं
• ऑपरेशन से पहले QLThumbnailRequestIsCancelled(thumbnail) जाँच करें जो काफी समय ले सकता है

पीढ़ी का पूर्वावलोकन करें

उदाहरण में, हम HTML को पूर्वावलोकन के रूप में पॉप्युलेट और प्रदर्शित करने का तरीका देखेंगे।
आपको पहले साँचा टेम्पलेट तैयार करना होगा। (वहाँ आप डिजाइन के लिए शैलियाँ भी शामिल कर सकते हैं):

 <!DOCTYPE html> <html lang="en"> <body> <div> <h1>App info</h1> Name: <strong>__CFBundleDisplayName__</strong><br /> Version: __CFBundleShortVersionString__ (__CFBundleVersion__)<br /> BundleId: __CFBundleIdentifier__<br /> </div> </body> </html> 

सब कुछ जिसे __KEY__ चुना गया है, वह जनरेटर से भरा जाएगा।

मैं अंतिम GeneratePreviewForURL.m लाता हूं:

 #import "Shared.h" OSStatus GeneratePreviewForURL(void *thisInterface, QLPreviewRequestRef preview, CFURLRef url, CFStringRef contentTypeUTI, CFDictionaryRef options); void CancelPreviewGeneration(void *thisInterface, QLPreviewRequestRef preview); /* ----------------------------------------------------------------------------- Generate a preview for file This function's job is to create preview for designated file ----------------------------------------------------------------------------- */ OSStatus GeneratePreviewForURL(void *thisInterface, QLPreviewRequestRef preview, CFURLRef url, CFStringRef contentTypeUTI, CFDictionaryRef options) { @autoreleasepool { NSURL *URL = (__bridge NSURL *)url; NSString *dataType = (__bridge NSString *)contentTypeUTI; NSData *appPlist = nil; if([dataType isEqualToString:kDataType_app]) { // get the embedded plist for the iOS app appPlist = [NSData dataWithContentsOfURL:[URL URLByAppendingPathComponent:@"Info.plist"]]; } else if([dataType isEqualToString:kDataType_ipa]) { // get the embedded plist from an app archive using: unzip -p <URL> <files to unzip> (piped to standart output) NSTask *unzipTask = [NSTask new]; [unzipTask setLaunchPath:@"/usr/bin/unzip"]; [unzipTask setStandardOutput:[NSPipe pipe]]; [unzipTask setArguments:@[@"-p", [URL path], @"Payload/*.app/Info.plist"]]; [unzipTask launch]; [unzipTask waitUntilExit]; appPlist = [[[unzipTask standardOutput] fileHandleForReading] readDataToEndOfFile]; } else { return noErr; } if(QLPreviewRequestIsCancelled(preview)) { return noErr; } NSMutableDictionary *synthesizedInfo = [NSMutableDictionary dictionary]; NSURL *htmlURL = [[NSBundle bundleWithIdentifier:kPluginBundleId] URLForResource:@"template" withExtension:@"html"]; NSMutableString *html = [NSMutableString stringWithContentsOfURL:htmlURL encoding:NSUTF8StringEncoding error:NULL]; NSDictionary *appPropertyList = [NSPropertyListSerialization propertyListWithData:appPlist options:0 format:NULL error:NULL]; [synthesizedInfo setObject:[appPropertyList objectForKey:@"CFBundleDisplayName"] forKey:@"CFBundleDisplayName"]; [synthesizedInfo setObject:[appPropertyList objectForKey:@"CFBundleIdentifier"] forKey:@"CFBundleIdentifier"]; [synthesizedInfo setObject:[appPropertyList objectForKey:@"CFBundleShortVersionString"] forKey:@"CFBundleShortVersionString"]; [synthesizedInfo setObject:[appPropertyList objectForKey:@"CFBundleVersion"] forKey:@"CFBundleVersion"]; for (NSString *key in [synthesizedInfo allKeys]) { NSString *replacementValue = [synthesizedInfo objectForKey:key]; NSString *replacementToken = [NSString stringWithFormat:@"__%@__", key]; [html replaceOccurrencesOfString:replacementToken withString:replacementValue options:0 range:NSMakeRange(0, [html length])]; } NSDictionary *properties = @{ // properties for the HTML data (__bridge NSString *)kQLPreviewPropertyTextEncodingNameKey : @"UTF-8", (__bridge NSString *)kQLPreviewPropertyMIMETypeKey : @"text/html" }; QLPreviewRequestSetDataRepresentation(preview, (__bridge CFDataRef)[html dataUsingEncoding:NSUTF8StringEncoding], kUTTypeHTML, (__bridge CFDictionaryRef)properties); } return noErr; } void CancelPreviewGeneration(void *thisInterface, QLPreviewRequestRef preview) { // Implement only if supported } 

जैसा कि आप देख सकते हैं, पहले हम Info.plist को खोलते हैं (या इसे आर्काइव से निकालते हैं), फिर हम इसमें से कुछ डेटा को synthesizedInfo सहेजते हैं। synthesizedInfo से सभी कुंजी तदनुसार सेट की जाती हैं, जो template.html .html से भरी लाइन में होती template.html । परिणामी स्ट्रिंग को मापदंडों के साथ-साथ qlmanage में लौटा दिया गया है जो HTML के रूप में लौटाए गए डेटा प्रकार का वर्णन करता है।

निष्कर्ष

इस गाइड के अनुसार, आप अपने मालिकाना प्रारूप के लिए या किसी भी सामान्य प्रारूप के लिए त्वरित रूप से देखने और उत्पन्न करने के लिए प्लग-इन बना सकते हैं जिसे सिस्टम मानक रूप से नहीं पहचानता है।

ProvisionQL के रूप में, मैं प्लगइन कार्य के हिस्से के रूप में कार्यक्षमता में सुधार के लिए किसी भी सुझाव और पूल अनुरोध के लिए खुश हो जाएगा।