OpenHarmony requirements and compatibility

Before you begin to develop an OpenHarmony application in Tuanjie, check Tuanjie requirements and compatibility information for OpenHarmony to make sure you’re aware of any limitations for developing a Tuanjie application for this platform.

OpenHarmony support

Tuanjie supports OpenHarmony 3.2 (API level 9) and above. For more information, refer to OpenHarmonySdkVersions.

Graphics API support

OpenHarmony devices support Vulkan and OpenGL ES. This section contains information about the graphics APIs Tuanjie supports for OpenHarmony.

Notes：

1. New Tuanjie Projects don’t support OpenGL ES 2.0 by default. For information on how to add support for OpenGL ES 2.0, see OpenGL ES 2.0.

OpenGL ES 2.0

Tuanjie doesn’t include OpenGL ES 2.0 in its built-in set of graphics APIs for OpenHarmony by default. To add support for OpenGL ES 2.0:

1. Go to Edit > Project Settings.
2. In the Project settings window, select the Player tab, then open OpenHarmony Player Settings:
   
3. Open the Other Settings fold-out. In the Rendering section, disable Auto Graphics API. This makes the Graphics APIs list appear.
4. To add support for OpenGL ES 2.0, select Add (+) and choose OpenGLES2.

If you upgrade an old project that uses Auto Graphics API to a Tuanjie version that doesn’t include OpenGL ES 2.0 by default, Tuanjie will disable Auto Graphics API and manually add OpenGL ES 2.0 to the list.

Render pipeline compatibility

Not every render pipelineA series of operations that take the contents of a Scene, and displays them on a screen. Unity lets you choose from pre-built render pipelines, or write your own. More info
See in Glossary is compatible with Openharmony due to hardware and graphics API limitations.

Module element attributes

This section contains compatibility information on OpenHarmnoy App Module element attributes.

Emulator compatibility

Tuanjie doesn’t support OpenHarmony emulators. To test your application, you can:

• Test on an OpenHarmony device.
• If you only need to test mobile input for your application, use Tuanjie Remote.
• If you only need to test the appearance of an OpenHarmony device, use the Device Simulator.

Texture compression

The standard texture compression formats on OpenHarmony are Ericsson Texture Compression (ETC) and Adaptable Scalable Texture Compression (ASTC). To target the widest range of OpenHarmony devices, use one of these texture compression formats. Tuanjie’s default texture compression format is ASTC. If an OpenHarmony device doesn’t support the texture compression format you use for a texture, Tuanjie decompresses the texture at runtime. This increases memory usage and decreases rendering speed.

A subset of OpenHarmony devices support the DXT and PVRTC texture compression formats. These formats support textures with an alpha channel as well as high compression rates or high image quality. For digital distribution services that filter content based on texture compression format, it is best practice to create separate builds of your application for each texture compression format.

There are two ways to change the default texture compression format for your application:

• In OpenHarmony Player Settings with the Texture compression format setting.
• In OpenHarmony Build Settings with the Texture Compression setting. The default value for this is Use Player Settings.

The value you set in Build Settings has priority over the one you set in Player Settings. Use it to change the texture compression format for a particular build.

You can also customize the texture compression format for individual textures. The value you set for an individual texture overrides the default texture compression format value. For information on how to change the texture format of individual textures, see Texture Importer.

Playing video files

This section provides additional information for playing video files on OpenHarmony:

• To play video files on OpenHarmony, use the Video Player component. If your application tries to play a video file that the device doesn’t support, Tuanjie doesn’t play the video.

• You can use any resolution or number of audio channels so long as the target device supports them. Note: Not all devices support resolutions greater than 640 × 360.

• Tuanjie supports playback from uncompressed asset bundles. For OpenHarmony Pie and above, Tuanjie supports playback from compressed asset bundles.

• Tuanjie doesn’t support native webM/VP8 transparency. To play VP8-encoded webM clips with transparency, transcode the clips to a supported format.

• Tuanjie reports format compatibility issues in the hdc hilog output and prefixes them with OpenHarmonyVideoMedia. This file might display other device-specific error messages near the video format issues Tuanjie reports. These device-specific errors aren’t visible to Tuanjie and often explain what the compatibility issue is.