Skip to content

Fix typo ios page #172

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Mar 4, 2024
Merged

Fix typo ios page #172

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
59 changes: 29 additions & 30 deletions docs/gdevelop5/publishing/ios/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,24 +1,24 @@
---
title: Publish your game to iOS
---

# Publish your game to iOS

GDevelop can automatically package your game for iOS so that you can test it on your iPhoen. GDevelop is also able to automatically send it to the App Store Connect, the website where you can publish your game on the App Store and send it to your iPhone or to other testers using *TestFlight*.
GDevelop can automatically package your game for iOS so that you can test it on your iPhone. GDevelop is also able to automatically send it to the App Store Connect, the website where you can publish your game on the App Store and send it to your iPhone or to other testers using _TestFlight_.

!!! note

GDevelop cloud builds, which includes automatic packaging for Android, iOS and desktop, are part of GDevelop memberships. Check the [GDevelop website](https://gdevelop.io/pricing) to compare the different plans and which one will work best for you.


## Making sure that your game is ready for packaging

It is important to verify that your game is ready to be exported for iOS:

* In the game properties that are accessible from the [Project Manager](/gdevelop5/interface)), make sure to enter a valid _package name_. A package name is an identifier like this: `com.yourname.gamename`. It's like the address of a website but reversed. You can choose any package name provided that:
* It is not used by another game or application on iOS or Android.
* It is written with only letters, numbers, and dots. Only put one dot between words (for example, `com..mygame` or `..mygame` are not valid). _Limit this identifier to 2-5 words maximum._
* You properly registered it on the [App Store Connect website](./app-store), if you want to publish it on the App Store.
* Also check that you've included the required icons.
- In the game properties that are accessible from the [Project Manager](/gdevelop5/interface)), make sure to enter a valid _package name_. A package name is an identifier like this: `com.yourname.gamename`. It's like the address of a website but reversed. You can choose any package name provided that:
- It is not used by another game or application on iOS or Android.
- It is written with only letters, numbers, and dots. Only put one dot between words (for example, `com..mygame` or `..mygame` are not valid). _Limit this identifier to 2-5 words maximum._
- You properly registered it on the [App Store Connect website](./app-store), if you want to publish it on the App Store.
- Also check that you've included the required icons.

## Create your Apple Developer account

Expand All @@ -28,27 +28,27 @@ Open your Apple Developer account on [Apple Developer website](https://developer

Click on the **Share** button in the GDevelop toolbar, then choose **iOS** and **One-click packaging**.

Choose if you want to package the game for testing it on an iPhone or an iPad, that was registered on your Apple Developer account, or if you want to publish it to App Store Connect - so it can be tested using *TestFlight* and then reviewed and published on the App Store.
Choose if you want to package the game for testing it on an iPhone or an iPad, that was registered on your Apple Developer account, or if you want to publish it to App Store Connect - so it can be tested using _TestFlight_ and then reviewed and published on the App Store.

### Create a new certificate

To make sure that your game can be run on an iPhone or iPad, you need to create a certificate (one for development and one for distribution on the App Store). GDevelop will guide you through the process:

In the page to do the one-click packaging for iOS, click on **Add new**.

* You first need to create a Certificate Signing Request (CSR). Enter your full name (or organisation name), country and press **Create request**. Then, click on the button to **download** the CSR.
* Go to the [Apple Developer certificate page](https://developer.apple.com/account/resources/certificates/list) and click on the **+** button.
- You first need to create a Certificate Signing Request (CSR). Enter your full name (or organisation name), country and press **Create request**. Then, click on the button to **download** the CSR.
- Go to the [Apple Developer certificate page](https://developer.apple.com/account/resources/certificates/list) and click on the **+** button.

* Choose either **Apple Development** (for testing on your iPhone/iPad) or **Apple Distribution** (for the App Store/TestFlight) and then **Continue**.
- Choose either **Apple Development** (for testing on your iPhone/iPad) or **Apple Distribution** (for the App Store/TestFlight) and then **Continue**.

![Choose type of certificate](./certificate-choose-type.png)
![Choose type of certificate](./certificate-choose-type.png)

* Upload the **CSR file** you downloaded in the previous step.
* Finally, **download the certificate** (.cer file) that was generated by Apple.
- Upload the **CSR file** you downloaded in the previous step.
- Finally, **download the certificate** (.cer file) that was generated by Apple.

* Go back in GDevelop and upload the certificate you just downloaded.
- Go back in GDevelop and upload the certificate you just downloaded.

Your certificate is now ready to be used by GDevelop. You now need to create a provisioning profile that will allow your game to be run on your iPhone or iPad (in case your created a *Apple Development* certificate), or sent to the App Store (in case you created a *Apple Distribution* certificate).
Your certificate is now ready to be used by GDevelop. You now need to create a provisioning profile that will allow your game to be run on your iPhone or iPad (in case you created a _Apple Development_ certificate), or sent to the App Store (in case you created a _Apple Distribution_ certificate).

### Register your device (for testing on your iPhone/iPad)

Expand All @@ -58,11 +58,11 @@ Your certificate is now ready to be used by GDevelop. You now need to create a p

Before creating a provisioning profile, you need to register your device. You can do this by going to the [Apple Developer devices page](https://developer.apple.com/account/resources/devices/list) and clicking on the **+** button.

* Enter your device name of your choice (for example "My iPhone").
* Enter the Device ID (UDID). You can find here using a few methods:
- Enter your device name of your choice (for example "My iPhone").
- Enter the Device ID (UDID). You can find here using a few methods:

* If you have a mac, connect the iPhone to your computer and open it using Finder. See [this page for more information](https://medium.com/@igor_marques/how-to-find-an-iphones-udid-2d157f1cf2b9).
* Otherwise, install iTunes and connect your iPhone to your computer (Windows or macOS). See [this page explaining how to find the UDID on iTunes](https://www.wikihow.com/Obtain-the-Identifier-Number-(UDID)-for-an-iPhone,-iPod-or-iPad).
- If you have a mac, connect the iPhone to your computer and open it using Finder. See [this page for more information](https://medium.com/@igor_marques/how-to-find-an-iphones-udid-2d157f1cf2b9).
- Otherwise, install iTunes and connect your iPhone to your computer (Windows or macOS). See [this page explaining how to find the UDID on iTunes](<https://www.wikihow.com/Obtain-the-Identifier-Number-(UDID)-for-an-iPhone,-iPod-or-iPad>).

Once you have the UDID, copy and paste it in the field and click **Continue**.

Expand All @@ -72,15 +72,15 @@ To create a provisioning profile, go to the [Apple Developer provisioning profil

![Add a provisioning profile from the Apple Developer website](./provisioning-profile-add.png)

* Choose either **iOS App Development** (for testing on your iPhone/iPad) or **App Store Connect** (for the App Store/TestFlight) and then **Continue**.
- Choose either **iOS App Development** (for testing on your iPhone/iPad) or **App Store Connect** (for the App Store/TestFlight) and then **Continue**.

![Choose provisioning type](provisioning-profile-choose-type.png)

* Choose *XCode iOS Wildcard App ID* and then **Continue**.
* Choose the certificate you created previously. If you don't see any certificate, you probably have mismatched the kind of certificate you created (development or distribution).
* For a profile used for *testing on your devices*, you'll be asked for checking the devices that you want to test on.
* Finally, click on **Continue** to create the provisioning profile. Download it.
* Go back to GDevelop and upload the provisioning profile you just downloaded.
- Choose _XCode iOS Wildcard App ID_ and then **Continue**.
- Choose the certificate you created previously. If you don't see any certificate, you probably have mismatched the kind of certificate you created (development or distribution).
- For a profile used for _testing on your devices_, you'll be asked for checking the devices that you want to test on.
- Finally, click on **Continue** to create the provisioning profile. Download it.
- Go back to GDevelop and upload the provisioning profile you just downloaded.

You can now close the window to create the certificate/provisioning profile. Your certificate and provisioning profile should be listed. You can close the window and start packaging your game for iOS.

Expand All @@ -97,12 +97,11 @@ If you want to test it on your iPhone/iPad, you need to install the IPA file on

Connect your iPhone/iPad to your computer using a USB cable.

* On a macOS computer, open Finder on your computer and navigate to the folder where the IPA file is located. Drag'n'drop the IPA file on the iPhone/iPad icon in the Finder window.
* On a Windows computer, open iTunes and connect your iPhone/iPad to your computer. Then, navigate to the folder where the IPA file is located. Click the "Apps" tab in the left sidebar menu. If the left sidebar is not visible, click the "View" tab in the top navigation menu, then click "Show Sidebar." Drag'n'drop the IPA file on the iPhone/iPad icon in the iTunes window. Connect your iPhone/iPad to your computer and click "Sync" in the iTunes window.

- On a macOS computer, open Finder on your computer and navigate to the folder where the IPA file is located. Drag'n'drop the IPA file on the iPhone/iPad icon in the Finder window.
- On a Windows computer, open iTunes and connect your iPhone/iPad to your computer. Then, navigate to the folder where the IPA file is located. Click the "Apps" tab in the left sidebar menu. If the left sidebar is not visible, click the "View" tab in the top navigation menu, then click "Show Sidebar." Drag'n'drop the IPA file on the iPhone/iPad icon in the iTunes window. Connect your iPhone/iPad to your computer and click "Sync" in the iTunes window.

## Publish to the App Store

To automatically publish your game on the App Store, you can set up an authentication key, enabling GDevelop to automatically send your game to the App Store Connect website. You will be able to set up the app and testers, including yourself, to test your game through the TestFlight app.

Read this page about [testing and publishing your game on the App Store](./app-store).
Read this page about [testing and publishing your game on the App Store](./app-store).