Skip to main content

You are viewing Agora Docs forBetaproducts and features. Switch to Docs

  • Core Products
  • Add-Ons
  • Extensions Marketplace

MacOS 15 Beta does not support apps that contain Chinese characters in the path

When developing on macOS 15 Beta system, if the path of the App and the App name contain non-English characters (for example, Chinese, Japanese, Korean, or others), the compiled Metal shader library may not contain any methods, causing the App to fail to run normally.

Cause of the problem​

This issue is cause by a system bug.

Solution​

This section takes the Chinese environment as an example to introduce how to create an InfoPlist file that supports multiple languages and define the name text displayed by the App. The specific steps are as follows:

  1. Create files for multi-language support:

    1. Open your project in Xcode and select the Info tab.

    2. In the Localizations section, click the + button and select Chinese, Simplified to localize your project to support Chinese characters.

    mac15beta-addlanguage

  2. Create the InfoPlist file:

    1. Add a new file:

      1. Right-click your project folder in the project navigator and select New File....
      2. In the pop-up dialog box, select String Catalog. mac15beta-choosetemplate

    2. Name the file InfoPlist and click Create.

    3. Set the language

      1. Select the InfoPlist file you just created in the project navigator, select the Chinese, Simplified language you have added, and click the + button.
      2. Add Key as CFBundleDisplayName and add the display name for it in the Chinese environment.
      Note

      If the original Info in your project is in Chinese, you need to set the display name in English at the same time to ensure that the names displayed in the Default Localization (zh-Hans) and English (en) fields are as expected.

      mac15beta-addkey

  3. Define the localized display name of the App:

    1. Select the target file in TARGETS and open the Info tab.

    2. Click the + button and add Key as Application has localized display name. Set Value to YES so that the display name of the App can be displayed as different text in different language environments.

      mac15beta-setdisplayname

  4. Verify the results:

    1. Make sure that no file names and App build paths in the project contain Chinese characters.
    2. Compile the project and build the App.
    3. Switch the language in System Preferences on the macOS system to ensure that the App name is displayed correctly in different languages.
vundefined