Skip to content

Latest commit

 

History

History
68 lines (50 loc) · 2.91 KB

build_ios.md

File metadata and controls

68 lines (50 loc) · 2.91 KB
Raw

Build for IOS

TPanel can be build also for IOS (iPad, iPhone). The cmake configuration contains the necessary options. The easiest way to do this is to use QtCreator. Start the QtCreator and open the cmake file CMakeLists.txt as a project.

On a Mac with Apple silicon, set arm64 as the base architecture (x86_64 is default).

Prerequisits

For IOS you need a Mac with XCode installed. You need also a developer account and a signature of a developer team if you want to compile the code for a real iPhone or iPad. For details look at Apple developer.

To be able to build TPanel for IOS you need the following libraries compiled for IOS and MacOS. For MacOS you may need them for the architectures ARM as well as Intel. For IOS you may need versions for 64 bit and 32 bit (from iOS version 17.0 on the 32Bit is no longer supported). It depends on what devices you have.

  • Skia
  • PjSIP
  • pcre
  • openssl (version 1.1 for Qt prior to 6.5.0 and version 3 for newer Qt)

You can (cross) compile them yourself or download the SDK (~3.5Gb!) from my machine. I recommend you to download the SDK. This saves you a lot of time. The following description assumes you've installed the SDK in the following directory structure:

SDKs
 +-openssl
 | +-include
 | +-IOS
 | +-IOSsim
 | +-lib
 +-pcre
 | +-include
 | +-lib
 +-pjsip
 | +-include
 | +-lib
 +-skia
   +-IOS32
   +-IOS64
   +-IOSsim
   +-IOSsim-apple
   +-IOSsim-intel

File: SDKs.tar.bz2

  • Download: SDKs.tar.bz2
  • SHA256 hash: 333a0bad139705c2b48c6e8ce37da959e9ce8e3284638f83d605464505463f98

Build with QtCreator

Start QtCreator and load the project file CMakeLists.txt. If you're on a Mac with Apple silicon (arm64 M1, M2 or newer) then you must set CMAKE_OSX_ARCHITECTURES to arm64 (default: x86_64).

In case you have unzipped the file SDKs.tar.bz2 in another directory then the HOME-directory, you must specify the path. Add the variable EXT_LIB_PATH to the Current configurations of cmake. Set it to the path where you've unzipped it.

Now you should be able to compile TPanel for IOS.

Using the script build_ios.sh

The repository comes with a shell script called build_ios.sh. With it you can compile TPanel on the command line. The script offers some parameters:

build_ios.sh [clean] [debug] [sign] [id <ID>] [help|--help|-h]
   clean     Delete old build, if there is one, and start a new clean build.
   debug     Create a binary with debugging enabled.
   sign      Sign the resulting app.
   id <ID>   The signing identity (team ID)

For example, start the script as follows:

./build_ios.sh clean sign

to build TPanel for an iPhone or iPad. If you've problems and get errors, open the script with an editor and adapt the paths and settings according to your needs.