Кроссплатформенное приложение на Qt: Mac App Store

Итак, для начала нужны три дополнительных файла: иконка*, Info.plist, Entitlements.plist

Info.plist

Этот файл содержит всю информацию о приложении (таблица рекомендуемых полей тут).

Вот минимальный каркас:

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> 	<key>CFBundleDevelopmentRegion</key> 	<string>Russian</string> 	<key>CFBundleDisplayName</key> 	<string>iStodo</string> 	<key>CFBundleExecutable</key> 	<string>iStodo</string> 	<key>CFBundleIconFile</key> 	<string>iStodo.icns</string> 	<key>CFBundleIdentifier</key> 	<string>ru.istodo.istodo</string> 	<key>CFBundleInfoDictionaryVersion</key> 	<string>6.0</string> 	<key>CFBundleName</key> 	<string>iStodo</string> 	<key>CFBundlePackageType</key> 	<string>APPL</string> 	<key>CFBundleShortVersionString</key> 	<string>1.1.0</string> 	<key>CFBundleSignature</key> 	<string>????</string> 	<key>NSPrincipalClass</key> 	<string>NSApplication</string> 	<key>LSApplicationCategoryType</key> 	<string>public.app-category.productivity</string> </dict> </plist> 

Для того, чтобы нестандартный plist автоматически добавлялся в бандл при каждой сборке, нужно добавить в файл проекта:

QMAKE_INFO_PLIST= $${PWD}/Info.plist 

Заодно сразу добавим в .pro файл пару строк для отладки:

QMAKE_CFLAGS += -gdwarf-2 QMAKE_CXXFLAGS += -gdwarf-2 

Entitlements.plist

Программы, устанавливаемые через App Store, будут работать в песочнице, для этого необходимо произвести некоторые приготовления. По правилам, нам, через QDesktopServices::storageLocation(), доступна папка вида имя_компании/имя_приложения (как это указано в iTunes Connect), потому нужно задать эти параметры явно:

QApplication::setOrganizationName("MyCompany") QApplication::setApplicationName("MyApp")  

Entitlements же, по сути, — файл разрешений, и те функции, которые в нем не указаны, будут заблокированы. Например, если мы хотим делать что-нибудь с сетью, следует установить флаг com.apple.security.network.client, и т.д. Возможные ключи с описаниями тут.

Ну и пример готового файла:

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> 	<key>com.apple.security.app-sandbox</key> 	<true/> 	<key>com.apple.security.files.user-selected.read-write</key> 	<true/> </dict> </plist> 

Публикация

Итак, можно выделить следующие ключевые моменты:

• Скопировать фреймворки и плагины Qt внутрь папки приложения
• Подписать
• Упаковать в формат .pkg
• Залить в iTunes Connect

Скопировать

Для того, чтобы программа могла запускаться не только на системах с установленным Qt SDK, нужно запустить специализированную утилиту — macdeployqt, которая скопирует все необходимые плагины и фреймворки в бандл приложения. К сожалению, из-за ошибки в этой утилите не копируются файлы Info.plist для фреймворков, что не является проблемой для работы, но без них не получится корректно подписать приложение. Нужно заметить, что если программа использует модуль QtSql, будут скопированы все доступные драйверы. Все бы ничего, но из-за libqsqlodbc.dylib приложение отклоняют с формулировкой «За использование приватных методов», а из-за libqsqlpsql.dylib ругаются на использование устаревшей библиотеки. Чтобы не искушать судьбу, перед публикацией стоит снести ненужные драйверы, заодно немного уменьшить размер пакета. Также для уменьшения размера можно удалить лишние плагины форматов изображений, и т.д.

Подписать

Начиная с OS X 10.9, нужно обязательно подписывать не только приложение, но и все фреймворки, плагины. Не смотря на то, что в Technical Note 2206 написано, что правильным будет подписывать не папку фреймворка, а каталог версии, на практике сделать это не получается, да и нареканий при ревью не возникло.
Примеры команд:

codesign -s "3rd Party Mac Developer Application: Developer Name" myApp.app/Contents/Frameworks/QtSql.framework/ codesign -s "3rd Party Mac Developer Application: Developer Name" myApp.app/Contents/PlugIns/platforms/libqcocoa.dylib  

После подписывания всех библиотек приходит очередь приложения целиком, как раз тут и используется файл Entitlements:

codesign --entitlements myAppEntitlements.plist -s "3rd Party Mac Developer Application: Developer Name"  myApp.app 

Проверяем, все ли прошло гладко:

codesign --display --verbose=4 myApp.app 

Упаковать

Тут все делается одной командой, которая, впрочем, изменилась с момента написания официального мануала:

productbuild --component "myApp.app" /Applications --sign "3rd Party Mac Developer Installer: Developer Name" --product "myApp.app/Contents/Info.plist" myApp.pkg 

Для пробы можно сразу же запустить получившийся пакет:

sudo installer -store -pkg myApp.pkg -target / 

Залить в iTunes Connect

Опять же ничего сложного, выбираем пункт Deliver your app, свое приложение, указываем путь до .pkg. Многие сталкиваются с проблемой (зависанием) в процессе заливки, рабочее решение тут.

Скрипт

В итоге получается очень много ручного труда: копировать файлы .plist для фреймворков, подписывать каждую библиотеку… Был написан скрипт на python, который полностью автоматизирует процесс. Предполагается, что скрипт лежит в каталоге сборки (или, по крайней мере, в одном каталоге с бандлом программы). Будет создана отдельная папка вида myApp_1.2, в которой, если все пройдет как надо, появится результат работы — файл .pkg. Для настройки следует отредактировать блок с параметрами — указать название приложения, версию, расположение Qt, название файла с разрешениями, информацию о разработчике:

version  = "1.2" appName  = "myApp" devName  = "Developer Name" pathToQt = "/Users/_USER_NAME_/Qt5.2.0/5.2.0/clang_64/"  entitlements = "myAppEntitlements.plist" 

# -*- coding: utf-8 -*-  import os import glob import shutil from subprocess import call  # Setup app info (Don't forget to change the version in the Info.plist) version  = "1.2" appName  = "myApp" devName  = "Developer Name" pathToQt = "/Users/_USER_/Qt5.2.0/5.2.0/clang_64/"  entitlements = "myAppEntitlements.plist"  fullApp  = appName +".app" dirName  = appName + "_" + version  # if we need only libqsqlite.dylib sqliteOnly = True  sqldriversDir = fullApp+"/Contents/PlugIns/sqldrivers/" frameworksDir = fullApp+"/Contents/Frameworks/" pluginsDir    = fullApp+"/Contents/PlugIns/"  print("Prepearing to deploy...") # Check files and paths  if not os.path.exists(pathToQt) or not os.path.isdir(pathToQt): 	print("Incorrect path to Qt") 	exit() if not os.path.exists(fullApp) or not os.path.isdir(fullApp): 	print("App bundle not found") 	exit() if not os.path.exists(entitlements) or os.path.isdir(entitlements): 	print("Entitlements file not found") 	exit()  #remove old build if os.path.exists(dirName): 	shutil.rmtree(dirName)  os.makedirs(dirName)  # Copy all necessary files to new folder shutil.copy(entitlements, dirName) shutil.copytree(fullApp, dirName+"/"+fullApp)  # Copy Qt libs for create independent app os.chdir(os.getcwd()+"/"+dirName) print("\nDeploying Qt to .app bundle...") call([pathToQt+"bin/macdeployqt", fullApp]) print("...done\n")  # Other libs in Qt 5.2(at least) will be rejected from Mac App Store anyway if sqliteOnly and os.path.exists(sqldriversDir): 	sqllibs = glob.glob(sqldriversDir+"*.dylib") 	for lib in sqllibs: 		if os.path.basename(lib) != "libqsqlite.dylib": 			os.remove(lib)  # Copy plists for frameworks (it's fix macdeployqt bug) frameworks = os.listdir(frameworksDir) for framework in frameworks: 	shutil.copy(pathToQt+"lib/"+framework+"/Contents/Info.plist", frameworksDir+framework+"/Resources/")  print("\nSigning frameworks, dylibs, and binary...") # Sign frameworks (it's strange, but we can't sign "Versions" folder) os.system('codesign -s "3rd Party Mac Developer Application: '+devName+'" '+frameworksDir+"*")  # Sign plugins pluginGroups = os.listdir(pluginsDir) for group in pluginGroups: 	os.system('codesign -s "3rd Party Mac Developer Application: '+devName+'"  '+pluginsDir+group+"/*")  # Sign app os.system('codesign --entitlements '+entitlements+' -s "3rd Party Mac Developer Application: '+devName+'" '+fullApp)  print("\nCheck signing:") os.system("codesign --display --verbose=4 "+fullApp)  # 	- - - print("\nBuilding package...") os.system('productbuild --component "'+fullApp+'" /Applications --sign "3rd Party Mac Developer Installer: '+devName+'" --product "'+fullApp+'/Contents/Info.plist" '+appName+'.pkg') print("...done\n")  print('\nFor test install, run follow command: sudo installer -store -pkg '+dirName+'/'+appName+'.pkg -target /') 

Bitbucket

Результат — https://itunes.apple.com/ru/app/istodo/id840850188?mt=12
В заключение можно сказать, что подготовить Qt приложение к публикации в Mac App Store не особо сложно, но делать все вручную — муторно.

Оглавление цикла статей

Официальные руководства:
developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/Introduction/Introduction.html
developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/SubmittingYourApp/SubmittingYourApp.html