Xcode "Build and Archive" из командной строки
Xcode 3.2 предоставляет потрясающую новую функцию в меню Build, "Build and Archive", которая генерирует файл.ipa, подходящий для специального распространения. Вы также можете открыть Организатор, перейти к разделу "Архивные приложения" и "Отправить приложение в iTunesConnect".
Есть ли способ использовать "Build and Archive" из командной строки (как часть сценария сборки)? Я бы предположил, что xcodebuild будет вовлечен как-то, но man страница, кажется, ничего не говорит об этом.
ОБНОВЛЕНИЕ Михаил Гринич запросил разъяснения; вот что именно вы не можете сделать с помощью сборок из командной строки, функции, которые вы можете делать ТОЛЬКО с Xcode Organizer после "Сборки и архивирования".
- Вы можете нажать "Поделиться приложением...", чтобы поделиться своим IPA с бета-тестерами. Как указывает Гийом ниже, из-за некоторой магии XCode этот файл IPA не требует отдельно распространяемого файла.mobileprovision, который требуется установить бета-тестерам; это волшебно Никакой сценарий командной строки не может это сделать. Например, сценарий Arrix (представленный 1 мая) не соответствует этому требованию.
- Что еще более важно, после того, как вы протестировали сборку, вы можете нажать "Отправить приложение в iTunes Connect", чтобы отправить эту ТОЧНУЮ сборку в Apple, тот самый двоичный файл, который вы тестировали, без перекомпоновки. Это невозможно из командной строки, потому что подписание приложения является частью процесса сборки; вы можете подписать биты для бета-тестирования Ad Hoc ИЛИ вы можете подписать их для отправки в App Store, но не для обоих. Ни один IPA, построенный на командной строке, не может быть бета-тестирован на телефонах, а затем отправлен непосредственно в Apple.
Я бы хотел, чтобы кто-то пришел и доказал, что я не прав: обе эти функции прекрасно работают в графическом интерфейсе XCode и не могут быть воспроизведены из командной строки.
19 ответов
Я нашел, как автоматизировать процесс сборки и архивирования из командной строки, я только что написал статью в блоге, объясняющую, как вы можете этого достичь.
Команда, которую вы должны использовать, xcrun:
/usr/bin/xcrun -sdk iphoneos PackageApplication \
-v "${RELEASE_BUILDDIR}/${APPLICATION_NAME}.app" \
-o "${BUILD_HISTORY_DIR}/${APPLICATION_NAME}.ipa" \
--sign "${DEVELOPER_NAME}" \
--embed "${PROVISONING_PROFILE}"
Вы найдете все детали в статье. Если у вас есть какие-либо вопросы, не стесняйтесь спрашивать.
С Xcode 4.2 вы можете использовать флаг -scheme, чтобы сделать это:
xcodebuild -scheme <SchemeName> archive
После этой команды Архив появится в Xcode Organizer.
Обновление моего ответа с помощью Xcode 9 и Swift
Архив
xcodebuild -workspace <ProjectName>/<ProjectName>.xcworkspace -scheme <schemeName> clean archive -configuration release -sdk iphoneos -archivePath <ProjectName>.xcarchive
IPA Export (обратите внимание на список параметров экспорта)
xcodebuild -exportArchive -archivePath <ProjectName>.xcarchive -exportOptionsPlist <ProjectName>/exportOptions.plist -exportPath <ProjectName>.ipa
Для тех, кто не знает о exportOptions.plist, https://blog.bitrise.io/new-export-options-plist-in-xcode-9
Те, кто использовал это для создания проекта в инструментах CI/CD, таких как teamcity/jenkins, пожалуйста, убедитесь, что вы используете правильный xcode, установленный в агенте сборки для архивации и экспорта.
Вы можете использовать любой из двух вариантов для этого.
- Используйте полный путь к xcodebuild,
/Applications/Xcode 9.3.1.app/Contents/Developer/usr/bin/xcodebuild
- Используйте xcode-select,
xcode-select -switch /Applications/Xcode 9.3.1.app
Ниже старый ответ
Вот скрипт командной строки для создания архива и пример IPA. У меня есть проект iPhone xcode, который находится в папке Desktop/MyiOSApp.
Выполните следующие команды одну за другой.
cd /Users/username/Desktop/MyiOSApp/
xcodebuild -scheme MyiOSApp archive \
-archivePath /Users/username/Desktop/MyiOSApp.xcarchive
xcodebuild -exportArchive -exportFormat ipa \
-archivePath "/Users/username/Desktop/MyiOSApp.xcarchive" \
-exportPath "/Users/username/Desktop/MyiOSApp.ipa" \
-exportProvisioningProfile "MyCompany Distribution Profile"
Это проверено с Xcode 5 и работает нормально для меня.
Я использовал свой собственный скрипт сборки для генерации пакета ipa для специального распространения.
die() {
echo "$*" >&2
exit 1
}
appname='AppName'
config='Ad Hoc Distribution'
sdk='iphoneos3.1.3'
project_dir=$(pwd)
echo using configuration $config
echo updating version number
agvtool bump -all
fullversion="$(agvtool mvers -terse1)($(agvtool vers -terse))"
echo building version $fullversion
xcodebuild -activetarget -configuration "$config" -sdk $sdk build || die "build failed"
echo making ipa...
# packaging
cd build/"$config"-iphoneos || die "no such directory"
rm -rf Payload
rm -f "$appname".*.ipa
mkdir Payload
cp -Rp "$appname.app" Payload/
if [ -f "$project_dir"/iTunesArtwork ] ; then
cp -f "$project_dir"/iTunesArtwork Payload/iTunesArtwork
fi
ipaname="$appname.$fullversion.$(date -u +%Y%m%d%H%M%S).ipa"
zip -r $ipaname Payload
echo finished making $ipaname
Скрипт также увеличивает номер версии. Вы можете удалить эту часть, если она не нужна. Надеюсь, поможет.
xcodebuild Инструмент может создавать и экспортировать архивные продукты с флагом -exportArchive (начиная с Xcode 5). Шаг экспорта ранее был возможен только через интерфейс Xcode Organizer.
Сначала заархивируйте ваше приложение:
xcodebuild -scheme <scheme name> archive
Дано $ARCHIVE_PATH (путь к файлу .xcarchive), экспортируйте приложение из архива одним из следующих способов:
Файл .ipa для iOS:
xcodebuild -exportArchive -exportFormat ipa -archivePath "$ARCHIVE_PATH" -exportPath "myApp.ipa" -exportProvisioningProfile "My App Provisioning profile"
Mac .app файл:
xcodebuild -exportArchive -exportFormat app -archivePath "$ARCHIVE_PATH" -exportPath "myApp.app" -exportSigningIdentity "Developer ID Application: My Software Company"
В обеих командах аргументы -exportProvisioningProfile и -exportSigningIdentity являются необязательными. man xcodebuild для деталей о семантике. В этих примерах в профиле обеспечения для сборки iOS указан профиль обеспечения распространения AdHoc, а в идентификаторе подписи для приложения Mac указан идентификатор разработчика для экспорта в качестве стороннего приложения (т.е. не распространяемого через Mac App Store).
Мы разработали приложение для iPad с XCode 4.2.1 и хотели интегрировать сборку в нашу непрерывную интеграцию (Jenkins) для распространения OTA. Вот решение, которое я придумал:
# Unlock keychain
security unlock-keychain -p jenkins /Users/jenkins/Library/Keychains/login.keychain
# Build and sign app
xcodebuild -configuration Distribution clean build
# Set variables
APP_PATH="$PWD/build/Distribution-iphoneos/iPadApp.app"
VERSION=`defaults read $APP_PATH/Info CFBundleShortVersionString`
REVISION=`defaults read $APP_PATH/Info CFBundleVersion`
DATE=`date +"%Y%m%d-%H%M%S"`
ITUNES_LINK="<a href=\"itms-services:\/\/?action=download-manifest\&url=https:\/\/xxx.xxx.xxx\/iPadApp-$VERSION.$REVISION-$DATE.plist\">Download iPad2-App v$VERSION.$REVISION-$DATE<\/a>"
# Package and verify app
xcrun -sdk iphoneos PackageApplication -v build/Distribution-iphoneos/iPadApp.app -o $PWD/iPadApp-$VERSION.$REVISION-$DATE.ipa
# Create plist
cat iPadApp.plist.template | sed -e "s/\${VERSION}/$VERSION/" -e "s/\${DATE}/$DATE/" -e "s/\${REVISION}/$REVISION/" > iPadApp-$VERSION.$REVISION-$DATE.plist
# Update index.html
curl https://xxx.xxx.xxx/index.html -o index.html.$DATE
cat index.html.$DATE | sed -n '1h;1!H;${;g;s/\(<h3>Aktuelle Version<\/h3>\)\(.*\)\(<h3>Ältere Versionen<\/h3>.<ul>.<li>\)/\1\
${ITUNES_LINK}\
\3\2<\/li>\
<li>/g;p;}' | sed -e "s/\${ITUNES_LINK}/$ITUNES_LINK/" > index.html
Затем Jenkins загружает файлы ipa, plist и html на наш веб-сервер.
Это шаблон 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>items</key>
<array>
<dict>
<key>assets</key>
<array>
<dict>
<key>kind</key>
<string>software-package</string>
<key>url</key>
<string>https://xxx.xxx.xxx/iPadApp-${VERSION}.${REVISION}-${DATE}.ipa</string>
</dict>
<dict>
<key>kind</key>
<string>full-size-image</string>
<key>needs-shine</key>
<true/>
<key>url</key>
<string>https://xxx.xxx.xxx/iPadApp.png</string>
</dict>
<dict>
<key>kind</key>
<string>display-image</string>
<key>needs-shine</key>
<true/>
<key>url</key>
<string>https://xxx.xxx.xxx/iPadApp_sm.png</string>
</dict>
</array>
<key>metadata</key>
<dict>
<key>bundle-identifier</key>
<string>xxx.xxx.xxx.iPadApp</string>
<key>bundle-version</key>
<string>${VERSION}</string>
<key>kind</key>
<string>software</string>
<key>subtitle</key>
<string>iPad2-App</string>
<key>title</key>
<string>iPadApp</string>
</dict>
</dict>
</array>
</dict>
</plist>
Чтобы настроить это, вы должны импортировать сертификат распределения и профиль обеспечения в цепочку ключей назначенного пользователя.
Я нашел некоторые другие ответы здесь трудно начать. Эта статья сделала, если для меня. Некоторые пути, возможно, должны быть абсолютными, как упомянуто в других ответах.
Команда:
xcrun -sdk iphoneos PackageApplication \
"/path/to/build/MyApp.app" \
-o "output/path/to/MyApp.ipa" \
--sign "iPhone Distribution: My Company" \
--embed "/path/to/something.mobileprovision"
Вы МОЖЕТЕ отказаться от сборки, как это делает XCode, так что вы можете протестировать и отправить тот же двоичный файл. Например, в моем сценарии (аналогичном описанному выше) я создаю свою версию выпуска, подписанную как сборку AdHoc, затем архивирую ее как IPA для тестирования, затем подаю в отставку с моим сертификатом распространения и создаю zip-файл, который я и отправляю Яблоко. Соответствующая строка:
codesign -f -vv -s "$DistributionIdentity" "$APPDIR"
Для Xcode 7 у вас есть намного более простое решение. Единственная дополнительная работа заключается в том, что вам нужно создать файл конфигурации plist для экспорта архива.
(По сравнению с Xcode 6, в результатах xcrun xcodebuild -help, -exportFormat а также -exportProvisioningProfile варианты больше не упоминаются; первый удаляется, а второй заменяется -exportOptionsPlist.)
Шаг 1, измените каталог на папку, включающую файл.xcodeproject или.xcworkspace.
cd MyProjectFolder
Шаг 2, используйте Xcode или /usr/libexec/PlistBuddy exportOptions.plist создать файл параметров экспорта. Кстати, xcrun xcodebuild -help скажет вам, какие ключи вы должны вставить в файл plist.
Шаг 3, создайте файл.xcarchive (фактически, папку) следующим образом (каталог build/ будет автоматически создан Xcode прямо сейчас),
xcrun xcodebuild -scheme MyApp -configuration Release archive -archivePath build/MyApp.xcarchive
Шаг 4, экспортируйте как.ipa-файл, как этот, который отличается от Xcode6
xcrun xcodebuild -exportArchive -exportPath build/ -archivePath build/MyApp.xcarchive/ -exportOptionsPlist exportOptions.plist
Теперь вы получаете файл ipa в каталоге build/. Просто отправьте его в Apple App Store.
Кстати, файл ipa, созданный Xcode 7, намного больше, чем Xcode 6.
Ниже я дал краткое описание шагов, которые необходимо выполнить, и параметров, которые необходимо передать при создании ipa с использованием terrminal:
Перейдите в папку, которая содержит файл MyApp.xcodeproject в терминале
Используя приведенную ниже команду, вы получите все цели приложения
/usr/bin/xcodebuild -listПосле выполнения вышеуказанной команды вы получите список целей, из которых вы должны выбрать конкретную цель, которую вы хотите сгенерировать.ipa
/usr/bin/xcodebuild -target $TARGET -sdk iphoneos -configuration ReleaseПриведенная выше команда создает проект и создает файл.app. Путь для поиска файла.app
./build/Release-iphoneos/MyApp.appПосле успешного завершения сборки выполните следующую команду, чтобы сгенерировать.ipa приложения, используя Имя разработчика и Профиль обеспечения, используя приведенный ниже синтаксис:
/usr/bin/xcrun -sdk iphoneos PackageApplication -v “${TARGET}.app” -o “${OUTDIR}/${TARGET}.ipa” –sign “${IDENTITY}” –embed “${PROVISONING_PROFILE}”
Объяснение каждого параметра в приведенном выше синтаксисе:
${TARGET}.app == Target path (ex :/Users/XXXXXX/desktop/Application/build/Release-iphoneos/MyApp.app)
${OUTDIR} == Select the output directory(Where you want to save .ipa file)
${IDENTITY} == iPhone Developer: XXXXXXX (XXXXXXXXXX)(which can be obtained from Keychain access)
${PROVISONING_PROFILE} == Path to the provisioning profile(/Users/XXXXXX/Library/MobileDevice/Provisioning Profiles/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX.mobileprovision”)
- ipa будет сгенерирован в выбранном выходном каталоге "$ {OUTDIR}"
Как построить проект iOS с помощью команды?
Clean : codebuild clean -workspace work-space-name.xcworkspace -scheme scheme-name
&&
Archive : xcodebuild archive -workspace work-space-name.xcworkspace -scheme "scheme-name" -configuration Release -archivePath IPA-name.xcarchive
&&
Export : xcodebuild -exportArchive -archivePath IPA-name.xcarchive -exportPath IPA-name.ipa -exportOptionsPlist exportOptions.plist
Что такое ExportOptions.plist?
ExportOptions.plist требуется в Xcode . Позволяет указать некоторые параметры при создании файла ipa. Вы можете выбрать параметры в дружественном пользовательском интерфейсе, когда вы используете Xcode для архивирования своего приложения.
Важный: метод для выпуска и развития отличается в ExportOptions.plist
Магазин приложений:
exportOptions_release ~ method = app-store
развитие
exportOptions_dev ~ method = development
Перейдите в папку, где находится корень вашего проекта и:
xcodebuild -project projectname -activetarget -activeconfiguration archive
Xcode 8:
Формат IPA:
xcodebuild -exportArchive -exportFormat IPA -archivePath MyMobileApp.xcarchive -exportPath MyMobileApp.ipa -exportProvisioningProfile 'MyMobileApp Distribution Profile'
Экспортирует архив MyMobileApp.xcarchive в виде файла IPA по пути MyMobileApp.ipa с использованием профиля обеспечения MyMobileApp Distribution Profile.
Формат приложения:
xcodebuild -exportArchive -exportFormat APP -archivePath MyMacApp.xcarchive -exportPath MyMacApp.pkg -exportSigningIdentity 'Developer ID Application: My Team'
Экспортирует архив MyMacApp.xcarchive в виде файла PKG по пути MyMacApp.pkg, используя удостоверение подписи катиона приложения приложения. Идентификатор разработчика. Приложение: Моя команда. Идентификатор подписи установщика Идентификатор разработчика Установщик: Моя команда неявно используется для подписи экспортируемого пакета.
Пройдя еще один шаг, загрузите в iTunesConnect через командную строку Xcode 7! (Предполагая, что вы начинаете с .ipa который был подписан с правильным профилем выпуска и подписью.)
Войти altool интерфейс CLI для загрузчика приложений (docs, стр. 38). Спрятанная глубоко в структуре Xcode.app, это удобная функция, которая позволяет загружать файлы непосредственно в ItunesConnect.
/Applications/Xcode.app/Contents/Applications/Application Loader.app/Contents/Frameworks/ITunesSoftwareService.framework/Versions/A/Support/altool
Просто беги $ altool --upload-app -f file -u username [-p password] загрузить свою новоиспеченную .ipa прямо в Apple. Пароль не является обязательным, и вам будет предложено ввести его, если вы не включите его в команду.
Если на этапе проверки возникнут проблемы с приложением, консоль распечатает их.
Вам, вероятно, придется экспортировать путь к altool если вы не хотите сохранять его местоположение.
export PATH=$PATH:/Applications/Xcode.app/Contents/Applications/Application\ Loader.app/Contents/Frameworks/ITunesSoftwareService.framework/Versions/A/Support/
Это оно! Просто войдите на iTunesConnect.com и выберите новую сборку для тестирования с помощью testflight.
Последнее замечание: если вы получаете сообщение об ошибке Exception while launching iTunesTransporter: Transporter not found at path: /usr/local/itms/bin/iTMSTransporter. You should reinstall the application Вы можете следовать предложению в этом ответе SO, чтобы запустить символическую ссылку на правильное местоположение:
ln -s /Applications/Xcode.app/Contents/Applications/Application\ Loader.app/Contents/itms /usr/local/itms
Улучшив ответ Винсента, я написал скрипт для этого: xcodearchive
Позволяет архивировать (генерировать ipa) ваш проект через командную строку. Думайте об этом как о сестре xcodebuild команда, но для архивации.
Код доступен на github: http://github.com/gcerquant/xcodearchive
Один из вариантов сценария - включить архивирование символов dSYM в архиве с метками времени. Нет оправдания для того, чтобы больше не хранить символы и не иметь возможности символизировать журнал аварий, который вы можете получить позже.
Если вы используете следующий инструмент: https://github.com/nomad/shenzhen
тогда эта задача очень проста:
which ipa 1>/dev/null 2>&1 || echo 'no shenzhen. to install use: sudo gem install shenzhen --no-ri --no-rdoc'
ipa build --verbose --scheme "${schemeName}"
После обновления до Xcode 8 я обнаружил, что корпоративный ipa генерирует
/usr/bin/xcrun -sdk iphoneos PackageApplication -v "${RELEASE_BUILDDIR}/${APPLICATION_NAME}.app" -o "${BUILD_HISTORY_DIR}/${APPLICATION_NAME}.ipa" --sign "${DEVELOPER_NAME}" --embed "${PROVISONING_PROFILE}"
Команда не может быть запущена из-за проблем с подписью. Журнал указывает, что "предупреждение: PackageApplication устарела, используйте
xcodebuild -exportArchiveвместо.
Поэтому я переключаюсь на xcodebuild -exportArchive и все вернулось в норму.
Попробуйте xctool, это замена для xcodebuild от Apple, которая упрощает создание и тестирование продуктов для iOS и Mac. Это особенно полезно для непрерывной интеграции. У него есть несколько дополнительных функций:
- Запускает те же тесты, что и Xcode.app.
- Структурированный вывод результатов сборки и тестирования.
- Удобный для человека цвет ANSI.
№ 3 чрезвычайно полезен. Я не могу, если кто-нибудь может прочитать вывод консоли xcodebuild, я не могу, обычно он дает мне одну строку с 5000+ символами. Даже труднее читать, чем дипломную работу.
Откройте Терминал и перетащите папку проекта:
cd / Users / имя пользователя / Рабочий стол / demo /
Выполните следующие команды одну за другой:
Создает приложение как "demo.xcodeproj" в архив
архив xcodebuild -project demo.xcodeproj -scheme demo -archivePath /Users/username/Desktop/demo.xcarchive
Если в вашем приложении есть Podfile fie as- "demo.xcworkspace" -
xcodebuild -workspace Project-Name.xcworkspace -scheme Scheme-Name -sdk iphoneos -configuration Release Provisioning_Profile= "Provision-Name" Development_Team= "Team-ID" архив -archivePath /Path/To/Output/AppName.xcarchive archive
Команда сборки экспорта IPA
Загрузите файл ExportOptions.plist отсюда
xcodebuild -exportArchive -archivePath /Users/shilpa/Desktop/demo.xcarchive -exportPath /Users/shilpa/Desktop/demo.ipa -exportOptionsPlist /Users/shilpa/Downloads/ExportOptions.plist
Вы найдете.xcarchive в.ipa, используя сведения о терминале в статье.
Вы имеете в виду подтвердить / поделиться / отправить варианты? Я думаю, что они специфичны для XCode и не подходят для инструмента сборки из командной строки.
С некоторой сообразительностью, держу пари, вы могли бы сделать сценарий, чтобы сделать это для вас. Похоже, они просто хранятся в ~/Library/MobileDevice/Archived Applications/ с UUDI и списком. Я не могу себе представить, что было бы так же трудно перепроектировать валидатор.
Процесс, который меня интересует, автоматизирует отправку сборок бета-тестерам. (Поскольку передача в App Store происходит нечасто, я не против делать это вручную, тем более что мне часто приходится добавлять новый текст описания.) Выполняя псевдо-сборку + архив с использованием CLI Xcode, я могу запускать автоматические сборки из каждого коммита кода, создавать файлы IPA со встроенными профилями обеспечения и отправлять их по электронной почте тестерам.