remote_ios_feature

in Tutorials, UE4

Remote iOS build using UE4 (Part 2)

A brief tutorial explaining how to configure and set-up a remote iOS build process on Unreal Engine 4 (v4.22+) for testing purposes, without spend money and time on a iOS developer license.

Creating mobile provision files
Remote iOS project set-up

remote_development_network

Setting-up remote build machine (Mac)

User Profile

The user name must be password protected (ssh remote control won’t work without a protected profile). The user name can’t have spaces and special characters

In System Preference > Sharing

mac_system_preferences

We must enable.

  • File Sharing
  • Remote Login
  • Remote Management.
mac_sharing

RSync

Rsync is an utility used by Unreal Engine to efficiently tranfer and synchronize files between a computer and an external disk and across networked computers by comparing the modification times and sizes of files.

Before start the configuration of the UE4 project we need to setup Rsync in our Mac machine.

We need to create a rsync.plist file into /Library/LaunchDaemons
Make sure the permissions of the file are rw-r–r– and paste:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
        <key>Disabled</key>
        <false/>
        <key>Label</key>
        <string>rsync</string>
        <key>Program</key>
        <string>/usr/bin/rsync</string>
        <key>ProgramArguments</key>
        <array>
                <string>/usr/bin/rsync</string>
                <string>--daemon</string>
        </array>
        <key>inetdCompatibility</key>
        <dict>
                <key>Wait</key>
                <false/>
        </dict>
		<key>Sockets</key>
		<dict>
			<key>Listeners</key>
			<dict>
				<key>SockServiceName</key>
				<string>rsync</string>
				<key>SockType</key>
				<string>stream</string>
			</dict>
		</dict>
</dict>
</plist>

And a rsyncd.conf into /etc/
Make sure the permissions of the file are rw-r–r– and paste:

1
2
3
4
5
6
7
[root]
path = /
hosts allow = 192.168.1.0/24uid = root
gid = wheel
read only = false
comment = Root volume

Hosts are the ip addresses, separate by comma, that can use this machine as the build machine. We have all machines in a local network using 192.168.1.x

To test the load of the module we can run

sudo launchctl load /Library/LaunchDaemons/rsync.plist

And finally restart our Mac machine.

Setting-up UE4 project machine (Windows)

DeltaCopy

To use RSync on Windows we must install DeltaCopy
Run the DeltaC.exe and setup it.

  • Profile Name: Must be the same as the name of the user name on Mac.
  • Server IP: Our Mac machine IP
  • Directory Name: root
win_delta_copy

Now we can start to configure the Unreal Engine 4 project to set-up and enable the remote iOS build

Go to Top Menu Edit > Project settings

project_settings

Platforms section > iOS

ios_project_settings

In Mobile Provision > Click on Import Provision button

ios_import_provision

Select the .mobileprovision file created in the previous tutorial and Open

import_provision_file

After that click on Import Certificate

ios_import_certificate

Select the .p12 file and Open

import_certificate_file

During the certificate import process a dialog will appear to request the password of this certificate. We need to put the password used to export the certificate in the previous tutorial.

Now in the Mobile Provision section must appear two new entries with a Valid status value.

ios_ue4_mobile_provision

We need to check that the Bundle Identifier starts with the name of the company of the provision file

ios_bundle_identifier

Scroll down until Build section > Remote Build Options and fill the next fields:

  • Remote Server Name: Our Mac machine IP
  • RSync User Name: The name of our previous DeltaCopy profile
  • Delta Copy Install Path: Path to our DeltaCopy program
win_remote_build_options

Now we can click on Generate SSH Key button. This process will connect to the Mac machine to generate the SSH Key and copy it back to a folder in the windows machine.

win_remote_ssh

Follow the console instructions until the end, but left the phassphrase empty.

After that the Found Existing SSH permission file field will be automatically filled with the path to the ssh key file

Now we can Package our project for iOS using a remote build from the
top Menu File > Package Project > iOS

win_remote_ios_ue4

And that’s all, now we can continue working on our Windows platform and package the project for iOS platform without physically switch to the Mac machine, and without spend money in a iOS developer license only for testing purposes.

Removing provision files

If we want to remove a provision file or a certificate on Windows platform we can go to

C:\Users\xxxx\AppData\Local\Apple Computer\MobileDevice\Provisioning Profiles\

win_provision

Select the provision and just delete it from the disk

To remove the certificate we can open a Command prompt and run Certmgr to open the Certificate Manager tool.

Go to Personal > Certificates

win_certmgr_delete

Right click on the certificate and Delete


Support this blog!

For the past year I've been dedicating more of my time to the creation of tutorials, mainly about game development. If you think these posts have either helped or inspired you, please consider supporting this blog. Thank you so much for your contribution!


Write a Comment

Comment

three × 3 =