Uploading Your App

This guide will help you upload your app’s APK (for Android) and IPA (for iOS) so that you can start automating tests with Sofy.

Note: If you’re uploading an IPA file for iOS devices, we recommend visiting Considerations for IPA files before uploading your file.

You can upload your applications using one of the following methods:

• In Sofy Portal
• In Sofy Lab
• Via CI/CD

Sofy Portal

You can upload your app in two ways:

App Manager:

1. Log into your Sofy account

2. Select App Manager from the left navigation bar

3. Click on Add Application.

4. You will notice the Add New Application modal open up.

5. You can now either drag and drop the app into the shown space or click on Browse Files to upload an application that is saved on your local system.

6. By clicking on Browse Files, another modal opens where you select the APK and iOS build to upload.

(Note: if you’re using a trial account, you can only upload APK files. If you want to add the IPA file you must contact the sales team to upgrade your plan.)

7. The application will then start downloading.

8. If you have an Enterprise build, an Enterprise certification is required. Otherwise, Sofy will automatically re-sign the app.

9. (Optional) If you’re uploading an IPA file and are enrolled in the Apple Developer Enterprise program, check the Requires enterprise certification box.

10. Provide the Enterprise Certificate Name. Click Save.

11. Then Click on Continue where I left off.

12. If the certificate hasn’t been added yet, go to Builds in App Manager.

13. Select the package, then click the arrow to open the dropdown.

14. Check the box next to the date on the right.

15. Add the certificate and click Save.

General Header:

• Alternatively, you can upload your application by clicking on the top right of the navigation bar in the Sofy portal as shown below and following the steps as you would when uploading in App Manager.

Sofy Lab

1. Acquire a device in Sofy's Device Lab.
2. In Device window, click the dropdown arrow at the top left of the header.

Note: You can only upload the APK file when you acquire an android device, throwing an error otherwise, and vice versa.

3. A slide menu of App Manager opens up. Towards the bottom, you can click on the Choose Your Application File space to upload your application.

(Note: if you’re using a trial account, you can only upload APK files. If you want to add the IPA file you must contact the sales team to upgrade your plan.)

Add New Build

If you have the same app with different builds and package names, and you want to run the same test case on each, you can do this by clicking Add New Build to upload each version. Make sure to upload IPA files only under iOS application and APK files only under Android Application.

To upload the same app with different packages, follow these steps:

1. Go to App Manager
2. Click on Builds
3. Select Add New Build
4. Upload your file

CI/CD:

Sofy easily integrates with popular software development tools, making it simple to run tests and report issues. Just follow these steps to set up the integration.

• Navigate to the App Manager
• Click on CI/CD Integration.

You can integrate Sofy with CI/CD pipeline using tools like:

• DevOps
• CircleCI
• AppCenter
• Bitrise
• Github Action
• Codemagic

Click on any tool to see setup details. You can also upload IPA or APK files using a Curl command. You can also integrate with your issue bug reporting systems, such as Jira and Azure DevOps from the Issue tracking tab.

Frequently Asked Questions:

• Can I upload and test both Android and iOS apps? What file formats are supported for testing on Sofy? Yes, you can upload and test your app on both Android and iOS devices. Sofy supports APK files for Android apps and IPA files for iOS apps. Once uploaded, the process for creating an automated test is the same.
• How can I upload my application build to Sofy? You can upload a build manually or via your CI/CD pipeline.
• Can I download an iOS app from the Apple App Store and upload and test it on Sofy? No, this isn’t possible because of how Apple designs its apps to operate on Apple devices. The best way to test an iOS app is to sign a developer-provisioned build with the UDIDs of Sofy iOS devices.
• How do I get the UDIDs of specific iOS devices if I don't want Sofy to resign builds for me? With a paid subscription, you can request iOS device UDIDs by sending an email to support@sofy.ai.
• What build types are supported for distributing iOS applications? We support the following build types: Signed Dev Provisioning builds, Ad Hoc builds, and Enterprise builds.
• I don't have a signed IPA. Is that a problem? Not at all. Sofy's automatic re-signing capability will kick in when Sofy detects an unsigned IPA. Click here to learn how to enable this feature.
• Can I upload multiple versions of the same app? Go to App Manager > Builds > Add New Build and upload each variant under the correct platform.
• Can I use CI/CD tools to integrate with Sofy? Yes. Sofy supports GitHub Actions, Bitrise, CircleCI, Azure DevOps, and others for automated builds.
• Can I upload IPA files with a trial account? No, trial accounts can only upload APKs; contact sales to enable IPA uploads.
• What if I have an Enterprise iOS build? You need to use an Enterprise certificate to sign the app so it can be installed and run on devices.
• Can I upload apps using a Curl command? Yes, Sofy allows uploads via Curl through the CI/CD integration tab.
• Can I report bugs using my issue tracking tools? Yes, integrate tools like Jira or Azure DevOps from the Issue Tracking tab.