platform_builder

Description:

platform builder

Platform Builder #
A Flutter library for performing platform checks and building widgets based on platform.
Platform checks #
import 'package:platform_builder/platform_builder.dart';

if (Platform.instance.isAndroid) {
print('android');
} else if (Platform.instance.isWeb) {
print('web');
}
copied to clipboard
Platform builders #
import 'package:platform_builder/platform_builder.dart';

class MyWidget extends StatelessWidget {
@override
build(context) {
return PlatformBuilder(
androidBuilder: (context) => Icon(Icons.android),
iOSBuilder: (context) => Icon(Icons.apple),
),
}
}
copied to clipboard
Platforms #
The libray provides builders for the following platforms:

android
iOS
macOS
linux
fuschia
windows
web
chrome extension

By default all platforms are enabled and the PlatformBuilder will throw an error if you forget to include an implementation for one of the supported platforms. To specify your preferred platforms, call the Platform.init to initialize the Platform singleton with the list of your application's supported platforms:
import 'package:platform_builder/platform_builder.dart';

Platform.init(
supportedPlatforms: {
Platforms.iOS,
Platforms.android,
Platforms.web,
}
);
copied to clipboard
If a particular PlatformBuilder needs to override the global list of supported platforms, such as during active development, you can pass an override to the widget:
import 'package:platform_builder/platform_builder.dart';

class MyWidget extends StatelessWidget {
@override
build(context) {
return PlatformBuilder(
supportedPlatforms: {Platforms.iOS, Platforms.android},
androidBuilder: (context) => Icon(Icons.android),
iOSBuilder: (context) => Icon(Icons.apple),
),
}
}
copied to clipboard
Builder precedence #
The precedence of builders is based on specificity. More specific builders take precedence over broader ones as shown below:
import 'package:platform_builder/platform_builder.dart';

class MyWidget extends StatelessWidget {
@override
build(context) {
return PlatformBuilder(
builder: (context) {...},
nativeBuilder: (context) {...},
androidBuilder: (context) {...},
),
}
}
copied to clipboard
In this example on a web platform, all three builders are applicable, but the precedence would be:

androidBuilder
nativeBuilder
builder

Platform Resolvers #
If you're looking to resolve a non-widget value by Platform, the PlaformResolver API can be used to resolve the desired platform value. Consider this example
// where we are resolving a value on Android:
import 'package:platform_builder/platform_builder.dart';

const platformResolver = PlatformResolver<String>(
defaultResolver: () => "Unknown",
androidResolver: () => "Android",
nativeResolver: () => "Native",
);

print(platformResolver.current) // Android
print(platformResolver.resolve(Platforms.iOS)) // Native
print(platformResolver.resolve(Platforms.web)) // Unknown
copied to clipboard
FAQs #


Q: Don't we already have a way to check the current Platform?


A Yes! But the Platform library from dart:io has some quirks like the fact that calling native platforms like Platform.isIOS on web throws an exception and that there is no check for web. We address both those issues here as well expanding the platform helpers to include other helpful platform utilities like the following:

Platform.instance.current: The current Flutter application platform.
Platform.instance.currentHost: The application's host operating system.
Platform.instance.isCanvasKit: Whether the application is using the CanvasKit renderer.
Platform.instance.isHtml: Whether the application is using the HTML renderer.



Q: Why a PlatformBuilder? Can't we just use if/else clauses in our build functions?


A: You definitely can! Here are some things we think a builder widget can help with:

It organizes branching your build functions by platform in a consistent way
It throws a runtime error if you forget to add a builder for one of your specified supported platforms so that you can catch that mistake in development
It abstracts having to repeat yourself with frequent platform checks throughout your application.



Tell us what you need #
Something missing? Let us know what additional platform utilities would be helpful for your workflow.