# Package generation IPA

After completing emulator debugging or real machine debugging of multi-terminal applications, developers can build IPA And installed to the phone for further testing, after the completion of the test can also build a formal version of IPA Used to submit App Store for audit, after the audit can be listed.

Go to the toolbar and clickto construct - Package generation IPA, enter the cloud build panel to complete the relevant configuration can be generated IPA

# I. Basic Information

The basic information comes from project.miniapp.json, if the developer needs to modify it can go to project.miniapp.json modify

# II. Bundle ID and Universal Link

Bundle ID The information comes from the configuration of the multi-terminal application console, if the multi-terminal application created by the developer has not yet bound to the mobile application account, the default is the platform assigned beta version. Bundle ID Constructed IPA
If the multi-terminal application created by the developer has a bound mobile application account, the mobile application configuration Bundle ID and Universal Link to construct IPA
Developers for modifications, click on theTo modifyYou can jump to Donut Modification of the development platform
Detailed operational guidelines are:Multiterminal application Bundle ID To configure

# III. Certificate Configuration

generate iOS The installation package needs to be used Apple Certificates and Profile (mobileprovision) File, the relevant configuration and explaination are as follows:

# 1. Provisional signature

A provisional signature means the adoption of Apple Automatic Account Management Signing Certificates and Profile (mobileprovision) The manner in which files such as files are generated and used:

Applies to Free Apple account
if Apple AppID (Bundle ID) Not registered yet, will automatically register Apple AppID (Bundle ID) To the Apple account
Apple AppID (Bundle ID) Will not open any capability(Some capability They do not support free accounts. AppID(Bundle ID)， Such as Apple Pay and In-App Purchase Etc.)
Need to be passed through USB will iPhone The phone is connected to the computer end, it automatically registers the device as the Apple Account Trust Device
Signing certificates are automatically created
Automatic generation Development of Profile。 If the Apple AppID (Bundle ID) Previously created. Profile, you will continue to use the old
The number of devices per application is limited to 100 platform
You can only create one application per account.
Generated IPA Can't get on the shelves to App Store

# 2. Certificate Signature

Certificate signing refers to the management by manually creating Apple Signature Certificates and Profile (mobileprovision) Files, and use those files to sign the way:

Applies to Apple Personal Accounts (charges apply)/Company Account (charge)
Can follow thefileregistered Apple AppID (Bundle ID)Create a certificate and generate Profile(mobileprovision) Documents, etc.
Using apples Development and Ad-hoc The product of the certificate build can be used to develop test
Products built using Apple Distribution Certificates can be used toShelves App Store

If the constructed IPA To submit to Apple for review and release, you need to selectCertificate signatureAnd the type of resource package you build to chooseOfficial version

ChoiceCertificate signatureAfter clicking OK for a moment, the developer is required to enter the "Signing Certificate Name"

The signature certificate name can be found in theKeychain Access - My certificate.View in

Added: If you are prompted that the certificate is invalid, you need to installApple Global Developer Relations Certification Media Intermediate Certificate。
Choice profile：Provisioning Profile , that is, the suffix name . Mobileprovision, need to be issued with a certificate

# IV. Resource Package Configuration

The types of resource packs are: official version, development version, development version (support remote debugging) and development version (support hot update), the difference between these versions and application scenarios can be viewedIntroduction to Version

# V. Application Version Configuration

Application version information comes from project.miniapp.json, if the developer needs to modify it can go to project.miniapp.json modify

# VI. Command Line Build

*** Need to upgrade developer tools to the latest version nightly *** Developers can use the command line build to build IPA The developer needs to first follow theDeveloper Tools Command Line Usage DocumentationPrepare the environment to execute the command, and look at the underlying usage.

Follow these steps:

First read the documentation on the use of the command line carefully
Executed according to the document cli open --project Open the corresponding project
If you do not log in, you need cli Login Login
After successful entry into the project, the execution cli build-ipa。 The support parameters are as follows (Align Tool Build Panel):

Parameter name	Function Dxplaination	Is required	Parameter Type
project	The project path, the absolute path for the system is required	yes	string
output	The save path of the build product, the absolute path for the system	yes	string
isDistribute	Whether to use the distribution certificate	no	boolean
isRemoteBuild	Whether to enable remote build (must use a distribution certificate)	no	boolean
profilePath	profile File address, the file format is Mobileprovision, relative path to relative item root path	no(Required when using Certificate of Distribution)	string
CertificateName	Signature Certificate Name	no(Required when using Certificate of Distribution)	string
p12Path	p12 File path, the file format is P12, relative path of relative item root path	no(Required when using remote builds)	string
p12Password	p12 cipher	no(Required when using remote builds)	string
tpnsProfilePath	tpnsProfile File path, relative path to relative project root path	no	string
isUploadBeta	Whether to upload the closed beta (only if you do not use the distribution certificate)	no	boolean
isUploadResourceBundle	Whether to upload resource packs	no	boolean
resourceBundleVersion	Resource Pack Version Number	no	string
resourceBundleDesc	Resource Pack Project Notes	no	string
version	Application version name	no	string
versionCode	Application version number	no	number
versionDesc	Application description	no	string

Example of Certificate Signing:

/Applications/wechatwebdevtools.app /Contents/MacOS/cli build-ipa --project /Users/test/project/miniprogram/mini-1 --output /Users/test/Downloads --isDistribute  true --isRemoteBuild false --profilePath distribute/distribute_com_tencentdonutminiapp _db.mobileprovision --certificateName 'XIAO TU (AN99464A2B)' --p12Path distribute/distribute.p12 --p12Password 123456 --tpnsProfilePath '' --isUploadBeta false --isUploadResourceBundle false --resourceBundleVersion '' --resourceBundleDesc '' --versionName  0.0.66 --versionCode  103 --versionDesc  A Simple Note

Cloud Build Example:

/Applications/wechatwebdevtools.app /Contents/MacOS/cli build-ipa --project /Users/test/project/miniprogram/mini-1 --output /Users/test/Downloads --isDistribute  true --isRemoteBuild true --profilePath distribute/distribute_com_tencentdonutminiapp _db.mobileprovision --certificateName 'XIAO TU (AN99464A2B)' --p12Path distribute/distribute.p12 --p12Password 123456 --tpnsProfilePath '' --isUploadBeta false --isUploadResourceBundle false --resourceBundleVersion '' --resourceBundleDesc '' --versionName  0.0.66 --versionCode  103 --versionDesc  A Simple Note