This article describes the processes and steps required for publishing VidyoConnect or VidyoEngage branded apps to the Apple and Google App Stores. The outline below includes two sections of instructions; the first section for iOS customers and the second section for Android customers. Although the procedural names are mostly the same in this table of contents; please make sure to follow the applicable steps for your specified device.
- iOS
- Overview
- Setting Up a Developer Program for iOS
- Uploading the iOS Application Using Transporter by Apple
- Understanding Warning and Error Messages
- Uploading the VidyoConnect-branded iOS Binary File
- Uploading the VidyoEngage-branded iOS Binary File
- Filling in an App Store Connect App Listing
- Uploading Screenshots to App Store Connect
- Updating the Application to the New Version
- Android
- Creating a Google Play Developer Account
- Creating an Application in the Google Play Console
- Creating an Application Store Listing
- Uploading an Application Using the Google Play Console
- Providing a Content Rating
- Setting Up a Pricing and Distribution Plan
- Making an Application Available in the Google Play Store
- Updating the Application to the New Version
- Android FAQs
iOS
Overview
The Apple Developer Program provides everything you need to build and distribute advanced capable apps to your worldwide customers on the App Store for iPhone, iPad, Mac, Apple Watch, Apple TV, and iMessage, and on the Safari Extensions Gallery . Also, you can deliver custom apps to specific businesses or proprietary apps within your organization. To learn more, visit the Apple Developer Program.
The Apple Developer Program handles all payment processing and there are no hosting fees. Additionally, this program offers:
- Access to beta software
- Advanced app capabilities such as:
- Integration with Siri to let user get things done with just their voice
- Ability to sell items with Apple Pay direct from within the app
- Ability to store app data in iCloud
- Extensive beta testing tools
- Share your beta bulids with TestFlight Beta Testing in App Store Connect to invite users to test before you release on the App Store
- App analytics
- Measures user engagement
- Assesses marketing campaigns
Setting Up a Developer Program for iOS
Before you enroll, you can get started by reviewing Apple's tools and resources (for free). These tools and resources include SwiftUI, Xcode, Swift, and TestFlight.
Enroll as an individual or as an organization at the Apple Developer Program Enroll page. As an individual, you will need your Apple ID with two-factor authentication turned on. As an organization, you'll need an Apple ID with two-factor authentication turned on and the following:
- A DUNS Number
- Legal Entity Status
- Legal Binding Authority
- A website
Enrolling in the Apple Developer Program
Before you enroll, you can get started by reviewing Apple's tools and resources (for free). These tools and resources include SwiftUI, Xcode, Swift, and TestFlight.
To enroll in the Apple Developer Program:
- Visit the Apple Developer Site and in the upper right, click the Account link.
- Click Create Apple ID. Fill in email, password and security information. Use an email address that you check often because Apple sends frequent updates on the program and on the status of apps submitted for approval.
- Scroll down and complete the remaining security questions and the captcha prompt, then click Continue.
- Check the email account you specified when registering. You should receive an email.
- The next page will prompt you to enter the code emailed to you. Enter the code and click Continue.
- Visit the Developer Member Center, and log in.
- The next page is the mandatory legal agreement. As always, it’s a good idea to consult with your lawyer before signing this and future agreements mentioned in this tutorial. When you’re ready, click the check box. Then click Submit.
- Once logged in, click the Join the Apple Developer Program link at the lower center of the page. Then, click Enroll.
- Click Start Your Enrolment.
- Select Individual / Sole Proprietor / Single Person Business, and click Continue.
- Enter your billing/business information to verify your identity. Apple will attempt to confirm this information with your credit card company, so make sure you enter it correctly. Fill in the remaining fields, and at the bottom, you’ll see another license agreement. When you’re ready, check the box and click Continue.
- Review your information, and when you’re ready to submit, click Continue.
- Now you will be prompted with the cost and summary for the purchase. You have the option for automatic renewal every year, which saves having to remember to renew and prevents any chance that your apps become unavailable (apps will be removed from the store once the account is no longer active). Check Automatic Renewal if you want this option, then click Purchase.
- Agree to the Terms & Conditions. If everything is okay, check the box and click Continue.
- Finally, confirm your intent to purchase the membership.
Enrolling in the Enterprise Apple Developer Program
The Enterprise Apple Developer Account is for large organizations to develop and deploy proprietary, internal-use apps to their employees through a secure internal system called Mobile Device Management solution. To learn more, click here.
Application Format
Enghouse-Vidyo provides two application formats in .ipa or .xcarchive:
- .ipa - This format is signed with an Enghouse-Vidyo Apple Developer account
The customer must proceed with the re-signing process to have an ability to upload using Transporter.
- .xcarchive - This format is an unsigned archive which you can upload using the instructions for either VidyoConnect or VidyoEngage based applications.
To enroll in the Enterprise Apple Developer Program:
- Click the following URL to Apple's enrollment page for their Enterprise program: https://developer.apple.com/programs/enterprise/enroll/
- Read through the "What You Need To Know" items, then click Start Your Enrollment at the bottom of the page.
- Make sure your Apple ID information is correct, select your Entity Type, then click Continue.
- Select the type of authority you have to enroll the company/organization in the Enterprise program.
- Fill out your organization's information.
- Fill out the CAPTCHA and click Continue.
- Once you have submitted your information, Apple will contact you to verify your information and will provide a direct link so that you can make the payment to finalize your enrollment in the Enterprise program.
VERY IMPORTANT: After your account has been fully setup/activated, there is a 2 week (14 day) waiting period before we can create the files we need in your account.
Uploading the iOS Application Using Transporter by Apple
To upload the iOS application using Transporter by Apple:
- Install "Transporter" from the App Store to your macOS machine.
- Sign in with Apple ID.
- Drag or click add IPA file for starting the delivery process.
- Click the Deliver button.
- During the delivery process, you may receive messages that you should wait for automatic restart.
- Wait for the completion of the delivery process.
Understanding Warning and Error Messages
After the uploading process, you may receive an email with one of the following warnings:
- ITMS-90473: CFBundleVersion Mismatch
- ITMS-90473: CFBundleShortVersionString Mismatch
- ITMS-90381: Too many symbol files
- ITMS-90809: Deprecated API Usage
These warnings are not errors and, therefore, will not result in App Store rejections or prevent you from releasing the application to the App Store.
Uploading the VidyoConnect-branded iOS Binary File
- Prerequisites
- Enghouse-Vidyo Professional Services Team requests an invitation to the Customer’s Apple Developer Program Team and requires “Developer Rights”.
- The developer on the customer side should have a macOS workstation with the following configurations/prerequisites:
- macOS 10.15.4 or later
- Xcode 11.4.1 or later
- iOS Distribution certificate with private key added to Keychain Access of the workstation
- The customer developer account used to log into Xcode application must have one of the following rights:
- Admin
- App Manager
- Procedure
- App Groups Identifier (allows access to group containers that are shared among multiple related apps, and allows certain additional interprocess communication between the apps) - must be in the following format: group.[BundleID of Screen Share extension]
- Application Bundle ID with capabilities:
- Access WiFi Information
- App Groups (select the App Groups you wish to assign to the bundle)
- Push Notification (to configure push notifications, a Client SSL Certificate that allows your notification server to connect to the Apple Push Notification Service is required) - create Production SSL Certificate.
- Screen Share extension Bundle ID with above-mentioned capabilities.
- App Store Distribution profile for application Bundle ID with iOS Distribution certificate inclusion.
- App Store Distribution profile for Screen Share extension Bundle ID with iOS Distribution certificate inclusion.
NOTE: Bundle IDs that will be created must be the same as was defined and confirmed with Enghouse-Vidyo team earlier.
- Log in to the App Store Connect.
- Click the My Apps button to go to the overview of the apps.
- Since this is the first time it will be uploading and publishing the app, a new app listing needs to be created. Click on the '+' sign in the top-left of the window and choose to create a New App.
- A new window will pop up and ask for several details about new app listing:
- Select the iOS checkbox.
- Enter a unique name into the Name field. If entered name has already been used in the App Store or registered by another developer, the name field will turn red and give an error.
- Choose a primary language for the app listing.
- Choose the Bundle ID which was created earlier for this app, click on the drop-down menu and find the Bundle ID in the list.
- Finally, enter an SKU – this is meant as a "code identifier", however, it is not really important for publishing. Simply entering the App Name in all capitals, followed by a number is sufficient.
- Click Create.
- The app listing should be created now.
- Open .xcarchive file provided by Enghouse-Vidyo team. The file will be opened in Xcode Organizer.
- Click Distribute App.
- Choose the iOS App Store method of distribution.
- On the next screen you will see the following two options:
- Upload destination - if you want to send the app to App Store Connect.
- Export - if you want to sign and export without uploading.
- In "App Store distribution options", leave the check boxes as they are, and click Next.
- On the next screen you will have the option to select how you want to re-sign the application:
- Automatically manage signing - Xcode will manage signing
- Manually manage signing - the manual process of signing
NOTE: The Enghouse-Vidyo Team recommends Automatic signing, but in order to manage the signing process, choose the Manual option.
- (Skip this step if you Select Automatically manage signing)
In the "Select certificate and iOS App Store profile", ensure that Team is corresponding:- [customer application].app - select appropriate profile (import or download)
- [customer application]ScreenShareExtension.appex- select appropriate profile (import or download)
- Export to export the application to the corresponding folder. Otherwise, select Upload.
- Press Export or Upload as needed.
- Preparation actions on Customer’s Apple Developer Account
- Customer should create the following:
- Creating App Store Connect App Listing
- Signing process
- Customer should create the following:
Uploading the VidyoEngage-branded iOS Binary File
- Prerequisites
- Enghouse-Vidyo Professional Services Team requests an invitation to the Customer’s Apple Developer Program Team and requires “Developer Rights”.
- The developer on the Customer side should have a macOS workstation with the following configurations/prerequisites:
- macOS 10.14.3 or later
- Xcode 10.2 or later
- iOS Distribution certificate with private key added to Keychain Access of the workstation
- The Customer developer account used to log into Xcode application must have one of the following rights:
- Admin
- App Manager
- Procedure
- App Groups Identifier (allows access to group containers that are shared among multiple related apps, and allows certain additional interprocess communication between the apps) - must be in the following format: group.[BundleID of Screen Share extension]
- Application Bundle ID
NOTE: Bundle IDs that will be created must be the same as was defined and confirmed with Enghouse-Vidyo team earlier. - Log in to App Store Connect.
- Click the My Apps button to go to the overview of the apps.
- Since this is the first time it will be uploading and publishing the app, a new app listing needs to be created. Click on the '+' sign in the top-left of the window and choose to create a New App.
- After that, a new window will pop up and ask for several details about new app listing:
- Select the iOS checkbox.
- Enter a unique name into the "Name" field. If entered name has already been used in the App Store or registered by another developer, the name field will turn red and give an error.
- Choose a primary language for the app listing.
- Choose the Bundle ID which was created earlier for this app, click on the drop-down menu and find the Bundle ID in the list.
- Finally, enter an SKU – this is meant as a "code identifier", however, it is not really important for publishing. Simply entering the App Name in all capitals, followed by a number is sufficient.
- Then click Create.
- The app listing should be created now.
- Open the .xcarchive file provided by Enghouse-Vidyo team. The file will be opened in Xcode Organizer.
- Click Distribute App.
- Choose the iOS App Store method of distribution.
- On the next screen you will see the following two options:
- Upload destination - if you want to send the app to App Store Connect..
- Export - if you want to sign and export without uploading.
- In "App Store distribution options", leave the check boxes as they are, and click Next.
- On the next screen you will have the option to select how you want to re-sign the application:
- Automatically manage signing - Xcode will manage signing
- Manually manage signing - the manual process of signing
NOTE: The Enghouse-Vidyo Team recommends Automatic signing, but in order to manage the signing process, choose the Manual option.
- (Skip this step if you Select Automatically manage signing)
In the "Select certificate and iOS App Store profile", ensure that Team is corresponding:
- [customer application].app - select appropriate profile (import or download)
- [customer application]ScreenShareExtension.appex- select appropriate profile (import or download)
- Export to export the application to the corresponding folder. Otherwise, select Upload..
- Press Export or Upload as needed.
- Preparation actions on Customer’s Apple Developer Account
- Customer should create the following:
- Creating App Store Connect App Listing
- Uploading
- Customer should create the following:
Filling in an App Store Connect App Listing
The steps below will show how to successfully fill in an app listing in App Store Connect and submit the app for review for the first time.
To fill in an App Store Connect app listing:
- The app listing should be created before, and it will be taken to the App Information section. There you will see the app name and Bundle ID, the app's newly created and assigned Apple ID number, and a few fields on the right that need filling in.
- The privacy policy URL should be the Customer privacy policy.
- The Category of the app falls under the appropriate category.
- After making these changes, click Save in the top-right of the window to save the work before going to the next section.
- Click Pricing and Availability in the left menu.
- Select the zero price for the app and the countries the app will be available in. By default, the app will be available in all countries.
Click Save in the top-right to save your work. - Navigate to the “Prepare for Submission” section in the menu. Upload the images and icon, and fill in the app description.
- Fill in the "Description" field. The text entered here will be visible as the app’s description in the App Store. Please note: there are some limitations to this field.
- Next to the description field, there are the Keywords, Support URL, and Marketing URL. In the Keywords field, enter the app name and event name as default terms. The Support URL is the link to where users can find support for the app. The Marketing URL is the marketing description of the app.
- The next section is the "Build" section where you can select the app build to attach to this app listing. Click on the '+' sign next to the heading, under "Build", and select your build in the window that pops up.
- App icon image will appear after you select the build.
- Click Save in the top-right to save your work.
- Next to the app icon section, there is the Copyright and Trade Representative section.
- Afterward, the app needs a Rating. Find the rating section underneath the App Icon section. By default, when the app listing is created the first time, the app has no rating. You must answer several questions in order to determine the rating of the app. Click Edit to open up a window with the questions.
- Fill in the App Review Information. Enter the contact information of the person responsible for the Apple Developer account within your organization. Typically, it is the person that has been given the Account Holder role in your organization. All fields are required.
Below that, there is a Demo Account field. This is the user account that Apple Reviewers will use to log into the app and check its functionality and viability for the App Store. Input an email address from your organization here and then make sure that you add the email as an attendee in the CMS for your events.
- Notes field - Additional information about the app that can help during the review process. Include information that may be needed to test the app, such as app-specific settings. This field is not visible in the app listing in the App Store.
- Determine when the app will be released into the App Store. Typically, it is best to leave it on the default setting “Automatically release this version” so that the app is available as soon as possible. If for some reason the app should be available from a certain date, choose this or release manually.
- Click Save to finalize the work and continue to app submission.
- Click Submit for Review. Three final questions about the app will appear. The following are the default answers for the app:
- Export Compliance – No
- Content Rights – No
- Advertising Identifier (IDFA) - No
- Click Submit. The status should have changed to “Waiting for Review”.
You can use the following page as a reference for all application statuses: https://help.apple.com/app-store-connect/#/dev18557d60e. On average, the application is reviewed during a 2-6 day time frame. If the submission is incomplete, review times may be further delayed or the app may be rejected. Once the app has been reviewed, its status will be updated and the customer will be notified.
Uploading Screenshots to App Store Connect
This section describes the process of creating screenshots (increasing/decreasing resolution) if the customer is responsible for publishing the iOS application and does not have the devices Apple requires.
Please upload appropriate screenshots for all required devices:
- For iPhone: Screenshots for 6.5-inch devices (iPhone 11 Pro Max, iPhone Xs Max) and 5.5-inch devices (iPhone 6s Plus, iPhone 7 Plus, iPhone 8 Plus) are required. These screenshots will scale down for smaller device sizes.
- For iPad: Screenshots for 12.9-inch iPad Pro (2nd generation) and 12.9-inch iPad Pro (3rd generation). These screenshots will scale down for smaller device sizes.
Upload up to ten screenshots. If your app is the same across multiple device sizes and localizations, simply provide the highest resolution screenshots required.
If you do not have the required devices, you should:
- Make screenshots of the application from iPhone 5.8-inch (iPhone 11 Pro, iPhone X, iPhone XS) and iPad 9.7-inch (iPad, iPad mini).
- Resize screenshots according to the required display specifications:
- For iPhone 6.5”: 1242 x 2688 px
- For iPad Pro 12.9” (2nd, 3rd Gen): 2048 x 2732 px
For the resizing process, please use any known offline or online software (Adobe Photoshop, Photopea, etc.).
Reference to App Store Connect Help:
Updating the Application to the New Version
To update the application to the new version:
- Click the plus button and click iOS.
- Enter a new version number.
- Prepare this version for publishing.
- Select the latest build in the build section.
- Add what's new content in the What's New section.
- Save and submit for review.
Use this useful Apple resource for creating a new version of an application. You can also use this reference as guidance.
Android
Creating a Google Play Developer Account
To create a Google Play developer account:
- Go to https://play.google.com/apps/publish/signup/.
- Click Create an Account.
- Fill out the form, and click Next Step.
- Click Back to Google Play Developer Console.
- Select the Google Play Developer distribution agreement check box to acknowledge your agreement, and click Continue to payment to pay the one-time $25 fee.
- Enter your payment information, and click Accept and continue.
- You will receive an email from Google notifying you when your account is ready to be activated.
Note: This process can take up to a week. - Activate your account.
Creating an Application in Google Play Console
To create an application in Google Play Console:
- Go to Play Console.
- Select All applications > Create application.
- Select a default language and add a title for your app.
The name of the app that you enter here will appear on Google Play.
Creating an Application Store Listing
These are all the details that will appear to customers when they view your app’s listing on Google Play.
This step doesn’t necessarily have to be completed before moving on to the next one. It can always be saved as a draft and revisited later when the application is ready to publish.
The information required for the store listing is divided into the following categories:
Product Details
There are three fields here that you need to fill out.
The app’s title and description should be written with a great user experience in mind.
Graphic Assets
Under graphic assets, you can add screenshots, images, videos, promotional graphics, and icons that showcase the app’s features and functionality.
Some sections under Graphic Assets are mandatory, such as screenshots, a feature graphic, and a high-resolution icon. Others are optional, but you can add them to make your app look more attractive to users.
There are specific requirements for each graphic asset that can be uploaded, such as the file format and dimensions. Read more about each requirement here.
Languages and Translations
You can also add translations of your app’s information in the store listing details, along with in-language screenshots and other localized images.
There’s also an option for users to view automated translations of the app’s information using Google.
Categorization
This part requires to select the appropriate type and category the app belongs to. From the drop-down menu, you can pick either app or game for the application type.
There are various categories for each type of app available on the Play Store. Pick the one the app fits into best.
In order to rate the content, an APK should be uploaded first. This step can be skipped and completed later.
Contact Details
This part requires you to enter contact details to offer users access to support regarding the app.
Multiple contact channels can be added here, such as an email, website, and phone number, but providing a contact email is mandatory for publishing an app.
Privacy Policy
For apps that request access to sensitive user data or permissions, a comprehensive privacy policy should be entered that effectively discloses how the app collects, uses, and shares that data.
URL linking must be added to the privacy policy in the store listing and within the app. Make sure the link is active and relevant to the app.
After completing these steps, the store listing is ready. Click Save Draft to save the details. Some steps can always be skipped, and you can come back to them later before publishing the app.
https://support.google.com/googleplay/android-developer/answer/113469#store_listing
Uploading an Application Using Google Play Console
The Android Package Kit (a.k.a., APK) is the file format used by the Android operating system to distribute and install apps. Simply put, the APK file contains all the elements needed for the app to actually work on a device.
Google offers multiple ways to upload and release the APK. Before uploading the file, however, an app release should be created.
To create a release:
- Select the created app.
- From the menu on the left side, navigate to Release management > App releases.
There are options available for the type of release. Production is the final release to submit a live version of the app to the Google Play store. Beta and Alpha releases give the opportunity to test the app and receive valuable feedback to make improvements before a final release. - Once an option has been picked, click Create release.
- Follow the on-screen instructions to add the APK files, and name and describe the release.
- Choose to use Google Play app signing on the app or click OPT-OUT to ignore and sign in locally.
NOTE: We recommend using Google Play app signing. It prevents the possibility of losing the signing key. - Click Browse Files.
- Choose the app’s APK or App Bundle files to upload.
- Click Review at the bottom right of the page. This confirms and submits the app’s release information.
Providing a Content Rating
To provide a content rating:
- Click Continue.
- Enter the email address and confirm it.
- From the options, select the app category.
- Start filling in the survey for the app rating.
This is basically to help Google identify if there is any explicit content in the app. - Click Save Questionnaire.
- Click Calculate Rating.
This will show the rating the app will have on the Play Store. - Click Apply Rating to confirm your app’s content rating.
Setting a Pricing and Distribution Plan
The pricing should be set if the plan is to have users pay for the app. Also, the app can be distributed to selected countries instead of a worldwide release.
- Go to the Pricing & distribution page from the left menu.
- Select whether the app should be FREE or PAID.
For more details on the paid option, check here. - Select Available for the countries the app released in. Select the Unavailable option otherwise.
- If the app is suitable for children under the age of 13, select Yes for Primary Child-Detected. Otherwise, select No.
Making an Application Available in the Play Store
To make an application available in the Play Store:
- Log in to Google Play Console.
- Go to the corresponding application.
- Go to App releases.
- Go to Edit release.
- Fill in What's new in this release? field or leave it empty. Then Save.
- Go to Review.
- Click Start rollout to production.
Updating the Application to the New Version
To update the application to the new version:
- Log in to the Google Play Developer Console.
- Locate the application in the app choices listed for the developer account. Click on the appropriate app.
- Click on Release Management, then App Releases.
- To upload a new .APK file, click on Manage Production, then Create Release.
- Drag and drop the new .APK file with increased version code into the "APKs to add" section. There will be a notice that the previous APK version will become deactivated. This is normal.
- The release name will automatically update to the next appropriate version. For "What's new in the release?", select Bug Fixes and Feature Enhancements.
- Click Save, then Review to proceed.
- Finally, review the release information on the next screen. Then scroll down to the bottom and click Start Rollout to Production.
Android FAQs
Q: How do I create Google Play Developer Program?
A: You can use the following guide for Creating A Google Play Developer Account.
Q: In which format will Enghouse-Vidyo provide the application?
The Enghouse-Vidyo team will provide the application in the following format: .apk - release unsigned.
The customer must proceed with the signing process in order to be able to upload to Google Play Console.
Q: What is the application store listing?
A: You can use the following page as a reference for all application statuses: Creating application store listing
Q: Do we have instructions for uploading applications using Google Play Console?
A: How to upload application using Google Play Console
Q: What the next step after uploading the application?
A: The next step is providing Content Rating and setting distribution and pricing. Please use the following documents:
Q: How long does the application review process take?
A: On average, the application is reviewed from 2-7 days.
Q: How can the next version of the application be updated?
A: Please use the following document as a reference for updating the application to the new version in Google Play Store: How to update the application to the new version
Comments
0 comments
Please sign in to leave a comment.