Under some circumstances the recommended operating environment for the SmartSDK Emulator may conflict with some Windows PC hardware.
Specifically, if the emulator is deployed to a PC that supports "High DPI Scaling" the Emulator UI components and text will render extremely small and may be completely unusable as a result.
This appears to be a conflict between the OpenJDK runtime and the operating system, as described in this Stack Exchange Q&A: How do I run Java apps upscaled on a high-DPI display?
There are two potential workarounds:
- Install and use an Oracle 8 JVM instead of the recommended Corretto 8 (OpenJDK based) JVM.
- Adjust the Windows DPI scaling in the Windows system settings to downscale to a lower DPI, either globally or (if possible) on a per-application basis.
(2) may or may not be acceptable, depending on the version of Windows being used, and what other applications may be affected. In the case of (1) it is recommended that vendors review any licensing requirements necessary for installing and running Oracle Java runtime environments or development kits. RiDP do not make any declarations about Oracle Java licensing, and our recommended JVM for any SmartSDK development continues to be an OpenJDK release such as Amazon Corretto 8.
Alternatively, the emulator can be run on hardware that does not support high DPI scaling.