You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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*.
7
+
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_.
7
8
8
9
!!! note
9
10
10
11
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.
11
12
12
-
13
13
## Making sure that your game is ready for packaging
14
14
15
15
It is important to verify that your game is ready to be exported for iOS:
16
16
17
-
* 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:
18
-
* It is not used by another game or application on iOS or Android.
19
-
* 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._
20
-
* You properly registered it on the [App Store Connect website](./app-store), if you want to publish it on the App Store.
21
-
* Also check that you've included the required icons.
17
+
- 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:
18
+
- It is not used by another game or application on iOS or Android.
19
+
- 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._
20
+
- You properly registered it on the [App Store Connect website](./app-store), if you want to publish it on the App Store.
21
+
- Also check that you've included the required icons.
22
22
23
23
## Create your Apple Developer account
24
24
@@ -28,27 +28,27 @@ Open your Apple Developer account on [Apple Developer website](https://developer
28
28
29
29
Click on the **Share** button in the GDevelop toolbar, then choose **iOS** and **One-click packaging**.
30
30
31
-
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.
31
+
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.
32
32
33
33
### Create a new certificate
34
34
35
35
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:
36
36
37
37
In the page to do the one-click packaging for iOS, click on **Add new**.
38
38
39
-
* 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.
40
-
* Go to the [Apple Developer certificate page](https://developer.apple.com/account/resources/certificates/list) and click on the **+** button.
39
+
- 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.
40
+
- Go to the [Apple Developer certificate page](https://developer.apple.com/account/resources/certificates/list) and click on the **+** button.
41
41
42
-
* Choose either **Apple Development** (for testing on your iPhone/iPad) or **Apple Distribution** (for the App Store/TestFlight) and then **Continue**.
42
+
- Choose either **Apple Development** (for testing on your iPhone/iPad) or **Apple Distribution** (for the App Store/TestFlight) and then **Continue**.
43
43
44
-

44
+

45
45
46
-
* Upload the **CSR file** you downloaded in the previous step.
47
-
* Finally, **download the certificate** (.cer file) that was generated by Apple.
46
+
- Upload the **CSR file** you downloaded in the previous step.
47
+
- Finally, **download the certificate** (.cer file) that was generated by Apple.
48
48
49
-
* Go back in GDevelop and upload the certificate you just downloaded.
49
+
- Go back in GDevelop and upload the certificate you just downloaded.
50
50
51
-
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).
51
+
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).
52
52
53
53
### Register your device (for testing on your iPhone/iPad)
54
54
@@ -58,11 +58,11 @@ Your certificate is now ready to be used by GDevelop. You now need to create a p
58
58
59
59
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.
60
60
61
-
* Enter your device name of your choice (for example "My iPhone").
62
-
* Enter the Device ID (UDID). You can find here using a few methods:
61
+
- Enter your device name of your choice (for example "My iPhone").
62
+
- Enter the Device ID (UDID). You can find here using a few methods:
63
63
64
-
* 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).
65
-
*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).
64
+
- 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).
65
+
-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>).
66
66
67
67
Once you have the UDID, copy and paste it in the field and click **Continue**.
68
68
@@ -72,15 +72,15 @@ To create a provisioning profile, go to the [Apple Developer provisioning profil
72
72
73
73

74
74
75
-
* Choose either **iOS App Development** (for testing on your iPhone/iPad) or **App Store Connect** (for the App Store/TestFlight) and then **Continue**.
75
+
- Choose either **iOS App Development** (for testing on your iPhone/iPad) or **App Store Connect** (for the App Store/TestFlight) and then **Continue**.
* Choose *XCode iOS Wildcard App ID* and then **Continue**.
80
-
* 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).
81
-
* For a profile used for *testing on your devices*, you'll be asked for checking the devices that you want to test on.
82
-
* Finally, click on **Continue** to create the provisioning profile. Download it.
83
-
* Go back to GDevelop and upload the provisioning profile you just downloaded.
79
+
- Choose _XCode iOS Wildcard App ID_ and then **Continue**.
80
+
- 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).
81
+
- For a profile used for _testing on your devices_, you'll be asked for checking the devices that you want to test on.
82
+
- Finally, click on **Continue** to create the provisioning profile. Download it.
83
+
- Go back to GDevelop and upload the provisioning profile you just downloaded.
84
84
85
85
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.
86
86
@@ -97,12 +97,11 @@ If you want to test it on your iPhone/iPad, you need to install the IPA file on
97
97
98
98
Connect your iPhone/iPad to your computer using a USB cable.
99
99
100
-
* 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.
101
-
* 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.
102
-
100
+
- 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.
101
+
- 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.
103
102
104
103
## Publish to the App Store
105
104
106
105
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.
107
106
108
-
Read this page about [testing and publishing your game on the App Store](./app-store).
107
+
Read this page about [testing and publishing your game on the App Store](./app-store).
0 commit comments