Files
apidash/doc/dev_guide/platform_specific_instructions.md
2025-01-14 09:50:11 +05:30

2.4 KiB

Platform-specific Additional Instructions

macOS

Add below keys to macos/Runner/DebugProfile.entitlements and macos/Runner/Release.entitlements.

	<key>com.apple.security.network.server</key>
	<true/>
	<key>com.apple.security.network.client</key>
	<true/>
	<key>com.apple.security.files.downloads.read-write</key>
	<true/>
	<key>com.apple.security.files.user-selected.read-write</key>
	<true/>

If not added, you can encounter a network connection error similar to the following while running your Flutter app on macOS:

ClientException with SocketException: Connection failed (OS Error: Operation not permitted, errno = 1)

You can read more here

In case you are having a local build failure on macOS due to "audio_session" do check out issue https://github.com/foss42/apidash/issues/510 for solution.

Android (Work in Progress)

Add the multiDexEnabled true line to the defaultConfig section at android/app/build.gradle file

android {
    ...
    defaultConfig {
        ...
        multiDexEnabled true
    }
}

For more information on multidex support, you can refer to the Android developer guide on Configuring Multidex.

Web

If you're building a Flutter app for the web, you may encounter a build error like:

Launching lib/main.dart on Chrome in debug mode...
../../../.pub-cache/hosted/pub.dev/printing-5.13.4/lib/printing_web.dart:218:16: Error: 
A value of type 'JSString' can't be assigned to a variable of type 'String'.
              .toJS;
               ^
Failed to compile application.

This happens because .toJS is no longer required for converting Dart strings to JavaScript strings in recent Dart versions.

Fix:
Update the printing_web.dart file in the cached printing package by removing .toJS as done in the PR here

script.innerHTML =
    '''function ${_frameId}_print(){var f=document.getElementById('$_frameId');f.focus();f.contentWindow.print();}'''
        .toJS;

Change it to:

script.innerHTML =
    '''function ${_frameId}_print(){var f=document.getElementById('$_frameId');f.focus();f.contentWindow.print();}''';

Read more about it here - https://github.com/DavBfr/dart_pdf/issues/1791