Mac Designer

Location of JRE Called by Designer on Mac

The JRE file called by the FineReport designer on Mac is in a hidden file in the installation directory /.install4j/jre.bundle.

Modifying the Memory Size of Designer on Mac

For Mac designers, the designer.vmoption is not stored in the bin folder. Instead, it is in the designer.app package.

Right-click designer, and click Show Package Contents, as shown in the following figure.

Open Content/vmoptions.txt, modify the size of -XMx2048m, and restart the designer for the changes to take effect.

Note:

You can also set startup parameters for the Mac designer here.

Mac Cache Path

You can query the cache path on Mac through the following address.

http://localhost:8075/webroot/decision/view/form?op=fr_base&cmd=evaluate_formula&expression=jvm()

For security concerns, the cache path is not displayed for subsequent versions and you can only see the version information of the JAR package.

Mac designer must have read and write permissions to the default cache path to start, which is under the current user directory. If the Mac designer cannot be granted permission due to special causes, contact the R&D team to customize the JAR package and modify the default path. 

Support Scope

There is a separate version of FineReport 11 whose designer is compatible with Apple Macs with M chips. The compatible version of FineReport 10 has not been developed yet. The general version of FineReport 11 can be used on Mac, but there may be compatibility issues if the macOS system is upgraded.

Mac Designer Installation Failure

Problem description: A dialog box pops up when double-clicking the installation package saying it cannot be opened or the file is damaged.

Cause analysis: It is due to the installation protection mechanism of the macOS system for software not downloaded from the APP store. Disabling the protection can solve the problem.

Solution:

(1) Enter sudo spctl –master-disable in the terminal to disable the installation protection forcefully. Or modify the allowable software sources to all sources in System Settings > Privacy & Security > General.

If none of the above works, you can right-click the installation package, select Get info, and tick Overwrite Malware Protection.

(2) Enter the following string in the Mac terminal, and reinstall the application after execution.

sudo xattr -r -d com.apple.quarantine / Path of the installation package

Abnormal Color Matching of Color Picker on Mac

Problem description: When using the designer on Mac 11.3.1, the color picker under Condition Attribute > Background > Edit can only get the desktop color if it is placed on other pages, such as browsers or Excel files. However, it can get the color of the designer's editing page.

Cause analysis: The designer does not have screen recording permission.

Solution: Choose System Settings > Privacy & Security > Privacy > Screen Recording, and enable Screen Recording for the designer.

Computer Damage Prompt due to Mac Designer Installation Error

Problem description: When installing an old version of the designer on a Mac, an error appears saying "FineReport will damage your computer. You should eject the disk image."

Cause analysis: The old version of the Mac installation package is unsigned, triggering macOS protection.

Solution: Right-click on the .app installation package, click Get Info, and tick Override Malware Protection in the properties.

Image Selection Failure in Designer

Problem description: The image in the desktop directory cannot be found when uploading an image to a cell.

Cause analysis: The designer does not have desktop folder permissions.

Solution: Grant the designer desktop folder permissions.

Designer Lags During Startup and Use

Problem description 1: FineReport 10 designer on Mac computers freezes or crashes when you perform operations on reports or charts. For example, the right panel freezes when you switch cell formats, or the designer is unresponsive when you check the process.

Cause analysis: The designer conflicts with Magnet, PopClip, and BetterAndBetter.

Solution: There is no better solution currently than uninstalling the conflicting software.

Problem description 2: Some Mac users experience freezing when clicking on dropdown menus and other widgets in the designer, but the thread stack monitoring is normal.

Cause analysis: It is caused by a JDK version bug. This issue occurs in JDK versions including 8u131, 9, 10, and 11.

Solution: Update the JDK version to 8u222 or 11.01.

Temporary solution: Disable Windows Manager under System Settings > Accessibility, or close all window management software on Mac.

Abnormal Editing Box of Chart Title When Setting Rich Text

Problem description: Mac users report that the Use HTML parsing text content button is unresponsive when it is used to customize the chart title in FineReport 11, with no editing box popping up. This issue only occurs in charts and the button works normally when configuring cells in general reports. 

Cause analysis: Same as the designer lags, this issue is caused by conflicts between the designer and Magnet.

Solution: Disable Magnet in Accessibility or uninstall Magnet.