Skip to content

README.md

Latest commit

 

History

History
66 lines (49 loc) · 1.88 KB

README.md

File metadata and controls

66 lines (49 loc) · 1.88 KB

MobileWebView

CMake Tests

Cross-platform native WebView for Qt applications — Android, iOS, macOS.

The repository contains:

  • mobilewebview/ — reusable Qt library (MobileWebView)
  • test-app/ — standalone test application that exercises the library
  • Makefile — single entry point for building and running on all platforms

Quick start

make run TARGET_OS=macos

Set the required environment variables for your target platform (see below), then run:

make run TARGET_OS=ios-simulator
make run TARGET_OS=ios
make run TARGET_OS=android
make run TARGET_OS=android-emulator

To build without launching the app:

make build TARGET_OS=ios-simulator

To clean the build directory for a target:

make clean TARGET_OS=ios-simulator

Required environment variables

TARGET_OS Variable Example
macos QTDIR ~/Qt/6.9.2/macos
ios-simulator QTDIR ~/Qt/6.9.2/ios
QT_HOST_PATH ~/Qt/6.9.2/macos
ios QTDIR ~/Qt/6.9.2/ios
QT_HOST_PATH ~/Qt/6.9.2/macos
DEVELOPMENT_TEAM YOUR_APPLE_TEAM_ID
android QTDIR ~/Qt/6.9.2/android_arm64_v8a
QT_HOST_PATH ~/Qt/6.9.2/macos
ANDROID_SDK_ROOT ~/Library/Android/sdk
ANDROID_NDK_ROOT ~/Library/Android/sdk/ndk/27.2.12479018
JAVA_HOME /usr/libexec/java_home -v 17
android-emulator same as android (use x86_64 Qt kit)

You can export these in your shell profile or pass them inline:

QTDIR=~/Qt/6.9.2/ios \
QT_HOST_PATH=~/Qt/6.9.2/macos \
DEVELOPMENT_TEAM=YOUR_APPLE_TEAM_ID \
make run TARGET_OS=ios

See BUILD.md for details on building MobileWebView as a static or dynamic library.