This crate provides easy Rust interfaces to open URIs across multiple platforms, including:
- macOS (via
NSWorkspace
) - Android (via
android/content/Intent
) - Linux (via
xdg-open
) - Windows (via
start
) - iOS (via
UIApplication
)
URIs take many different forms: URLs (http://
), tel:
, mailto:
, file://
, and more (see the official list of schemes).
use robius_open::Uri;
Uri::new("tel:+61 123 456 789")
.open()
.expect("failed to open telephone URI");
use robius_open::Uri;
Uri::new("http://www.google.com")
.open()
.expect("failed to open URL");
To use this crate on Android, you must add the following to your app manifest:
<uses-permission android:name="android.permission.QUERY_ALL_PACKAGES"
tools:ignore="QueryAllPackagesPermission" />
<queries>
<intent>
<action android:name="android.intent.action.MAIN" />
</intent>
</queries>
or alternatively, disable the android-result
feature.
However, disabling this feature will make Uri::open()
always return Ok
, regardless of whether the URI was successfully opened.