FlutterFlutter · Chapterبەش 9 · Lectureوانە 9.3

Opening Links and Other Apps with url_launcherکردنەوەی بەستەرەکان و ئەپەکانی تر بە ⁦url_launcher⁩

Packages and plugins; adding url_launcher 6.3; opening a website with launchUrl and handling failures; launch modes; starting a phone call with a tel: link; the schemes url_launcher supports; and the Android <queries> and iOS LSApplicationQueriesSchemes settings, and when canLaunchUrl needs them.

و ؛ زیادکردنی ⁦url_launcher 6.3⁩؛ کردنەوەی بە launchUrl و مامەڵەکردن لەگەڵ شکست؛ شێوازەکانی کردنەوە؛ دەستپێکردنی پەیوەندیی تەلەفۆنی بە tel:؛ ئەو ⁦url_launcher⁩ پشتگیرییان دەکات؛ و ڕێکخستنەکانی ⁦<queries>⁩ـی Android و LSApplicationQueriesSchemesـی iOS؛ هەروەها کەی canLaunchUrl پێویستی پێیانە.

17 min read17 خولەک خوێندنەوە · 15 stepsهەنگاو

What you will learnچی فێر دەبیت

Explain what a plugin is, and add url_launcher to a project.
Open a website with launchUrl, choose a launch mode, and handle both kinds of failure.
Open the phone app with a tel: link, and say what the user still has to do.
Write the Android <queries> and iOS LSApplicationQueriesSchemes entries, and say when canLaunchUrl needs them.

ڕوون بکەیتەوە چییە و ⁦url_launcher⁩ بۆ پڕۆژەیەک زیاد بکەیت.
بە launchUrl بکەیتەوە، شێوازێکی کردنەوە هەڵبژێریت و مامەڵە لەگەڵ هەردوو جۆری شکست بکەیت.
پەیوەندیکردن بە tel: بکەیتەوە و بڵێیت هێشتا دەبێت چی بکات.
تۆمارەکانی ⁦<queries>⁩ـی Android و LSApplicationQueriesSchemesـی iOS بنووسیت و بڵێیت کەی canLaunchUrl پێویستی پێیانە.

Opening other apps from your appکردنەوەی ئەپەکانی تر لە ئەپەکەتەوە

Many apps need a "Visit our website", "Call us" or "Send an e-mail" button. Your app does not contain a browser, a phone dialer or an e-mail program, and it should not. It asks the phone to open the right app instead. In Flutter this is done with the url_launcher package: it opens websites, creates e-mails, opens maps, starts a phone call, sends an SMS, and more. It lets your app interact with apps outside it.

زۆر پێویستیان بە «سەردانی بکە»، «پەیوەندیمان پێوە بکە» یان « بنێرە» هەیە. ، پەیوەندیکردن یان تێدا نییە و نابێت تێیدا بێت. لە جیاتی ئەوە داوا لە مۆبایلەکە دەکات گونجاوەکە بکاتەوە. لە ئەمە بە ⁦url_launcher⁩ دەکرێت: دەکاتەوە، دروست دەکات، نەخشە دەکاتەوە، پەیوەندیی تەلەفۆنی دەست پێ دەکات، دەنێرێت و زیاتر. ڕێگە بە دەدات لەگەڵ دەرەوەی خۆی کار بکات.

The key is the link itself. Your app hands the operating system a URI such as https://flutter.dev or tel:07500000000. The system looks at the scheme (the part before the colon) and opens the app that handles it. What URIs and schemes are is explained in the shared lesson URL, URI and URN.

کلیلەکە خودی . وەک https://flutter.dev یان tel:07500000000 دەداتە . سیستەمەکە سەیری (بەشی پێش دوو خاڵەکە) دەکات و ئەو دەکاتەوە کە کاری پێ دەکات. و چین لە وانە هاوبەشەکەدا ڕوون کراونەتەوە: URL، URI و URN.

Your app only hands over a URI; the operating system picks the app by its scheme. تەنها دەدات؛ بەپێی هەڵدەبژێرێت.CêIT

Quick checkپشکنینی خێراYour app calls launchUrl with tel:07500000000. Who decides which app opens? بانگی launchUrl بە tel:07500000000ـەوە دەکات. کێ بڕیار دەدات کام بکرێتەوە؟The operating system, from the scheme telسیستەمی وەگەڕخەر، لە سکیمی telـەوەFlutter's engineبزوێنەری FlutterThe mobile network operatorکۆمپانیای ڕایەڵەی مۆبایلYour app, by importing the phone app's codeئەپەکەت، بە import کردنی کۆدی ئەپی پەیوەندیکردن

Opening other apps from your appکردنەوەی ئەپەکانی تر لە ئەپەکەتەوە

The taxi officeنووسینگەی تاکسی

You do not drive yourself to every place; you give the taxi office a note with an address. The office sends the right car: a small taxi for the city, a minibus for a trip to another town. url_launcher is the note: your app writes the address (the URI), and the operating system sends the right app.

خۆت بۆ هەموو شوێنێک لێ ناخوڕیت؛ کاغەزێک بە ناونیشانێکەوە دەدەیتە نووسینگەی تاکسی. نووسینگەکە ئۆتۆمبێلی گونجاو دەنێرێت: تاکسییەکی بچووک بۆ ناو شار، مینیبۆسێک بۆ گەشتێک بۆ شارێکی تر. ⁦url_launcher⁩ ئەو کاغەزەیە: ناونیشانەکە () دەنووسێت و گونجاوەکە دەنێرێت.

Where the analogy stops workingسنووری ئەم نموونەیە

If the phone has two browsers, the user may be asked which one to use. And if there is no car for that trip, for example no e-mail app on the phone, nothing opens and your app must tell the user.

ئەگەر مۆبایلەکە دوو هەبێت، لەوانەیە پرسیار لە بکرێت کامیان بەکار بهێنێت. ئەگەر هیچ ئۆتۆمبێلێک بۆ ئەو گەشتە نەبێت، بۆ نموونە هیچ لەسەر مۆبایلەکە نەبێت، هیچ شتێک ناکرێتەوە و دەبێت بە بڵێت.

Quick checkپشکنینی خێراIn the analogy, what happens when there is no car for the trip?لە نموونەکەدا، کاتێک هیچ ئۆتۆمبێلێک بۆ گەشتەکە نییە چی ڕوو دەدات؟The office builds a new carنووسینگەکە ئۆتۆمبێلێکی نوێ دروست دەکاتThe phone installs a suitable app by itselfمۆبایلەکە خۆی ئەپێکی گونجاو دادەمەزرێنێتThe trip starts anywayگەشتەکە هەر دەست پێ دەکاتNothing opens, and your app must tell the userهیچ شتێک ناکرێتەوە و ئەپەکەت دەبێت بە بەکارهێنەر بڵێت

Packages and pluginsکتێبخانەکان و پاشکۆکان

Flutter apps use many ready-made packages (dependencies), so you do not write everything yourself and the work goes faster and easier. Packages are published on pub.dev. A plugin is a package that also contains platform code, in Kotlin or Java for Android and Swift or Objective-C for iOS, to reach the phone's own features. url_launcher is a plugin: opening another app needs Android and iOS code.

زۆر ئامادە () بەکار دەهێنن، بۆ ئەوەی خۆت هەموو شتێک نەنووسیت و کارەکە خێراتر و ئاسانتر بێت. لە ⁦pub.dev⁩ بڵاو دەکرێنەوە. کە کۆدی تێدایە، بە Kotlin یان Java بۆ Android و Swift یان ⁦Objective-C⁩ بۆ iOS، بۆ گەیشتن بە تایبەتمەندییەکانی خودی مۆبایلەکە. ⁦url_launcher⁩ : کردنەوەی تر پێویستی بە کۆدی Android و iOS هەیە.

Definitionپێناسە

An add-on that gives a program extra features. In Flutter, a plugin is a package that also contains platform code (Kotlin, Swift…) to reach phone features such as the camera, the dialer or Firebase.

پێوەکراوێکە کە تایبەتمەندیی زیادە دەداتە . لە ، پاشکۆ پاکێجێکە کە کۆدی تایبەت بە تێدایە (Kotlin، Swift…) بۆ گەیشتن بە تایبەتمەندییەکانی مۆبایل وەک کامێرا، ئەپی پەیوەندیکردن یان Firebase.

Add the packageکتێبخانەکە زیاد بکەBASHType in a terminalلە تێرمیناڵدا بینووسە

$ flutter pub add url_launcher

The line it adds to pubspec.yamlئەو دێڕەی بۆ ⁦pubspec.yaml⁩ زیادی دەکاتpubspec.yamlYAML

dependencies:
  flutter:
    sdk: flutter
  url_launcher: ^6.3.3

Then import it in your Dart fileپاشان لە فایلی Dartـەکەتدا importـی بکەDART

import 'package:url_launcher/url_launcher.dart';

Because a plugin brings Android and iOS code, stop the app and run it again after adding it. Hot reload only reloads Dart code; without a full rebuild you get a MissingPluginException. How pubspec.yaml and flutter pub add work in general is in pubspec.yaml: the project ID card.

چونکە کۆدی Android و iOS دەهێنێت، دوای زیادکردنی ڕابگرە و دووبارە کاری پێ بکەرەوە. تەنها کۆدی بار دەکاتەوە؛ بەبێ تەواو MissingPluginException وەردەگریت. pubspec.yaml و flutter pub add بە گشتی لە بەشی ⁦pubspec.yaml⁩ـدا ڕوون کراونەتەوە.

Quick checkپشکنینی خێراYou added url_launcher and pressed hot reload. Tapping the button gives MissingPluginException. Why?⁦url_launcher⁩ـت زیاد کرد و کرد. دەستلێدان لە MissingPluginException دەدات. بۆچی؟url_launcher does not work on phones⁦url_launcher⁩ لەسەر مۆبایل کار ناکاتYou must restart the computerدەبێت کۆمپیوتەرەکە دووبارە هەڵبکەیتەوەThe plugin's Android/iOS code is not in the running app yet; stop and run againکۆدی ⁦Android/iOS⁩ـی پاشکۆکە هێشتا لەناو ئەپە کارپێکراوەکەدا نییە؛ ڕایبگرە و دووبارە کاری پێ بکەرەوەThe URL is wrongURLـەکە هەڵەیە

Opening a websiteکردنەوەی تۆڕگەیەک

To open a URL in the browser, write a function and call it when the user taps a button that is linked to that URL. This is the notes' function (the notes open a university's website; here we use flutter.dev):

بۆ کردنەوەی لە ، بنووسە و کاتێک دەست لە دەدات کە بەو بەستراوە بانگی بکە. ئەمە تێبینییەکانە (تێبینییەکان زانکۆیەک دەکەنەوە؛ لێرەدا ⁦flutter.dev⁩ بەکار دەهێنین):

The notes' functionکردارەکەی تێبینییەکانDART

Future<void> _launchURL() async {
  String url = 'https://flutter.dev';
  if (!await launchUrl(Uri.parse(url))) {
    throw 'Could not launch $url';
  }
}

Explain the codeڕوونکردنەوەی کۆدەکە

Lineدێڕی 1

Future<void> and async: launching takes time, so the function is asynchronous.

Future<void> و async: کردنەوە کاتی دەوێت، بۆیە .

Lineدێڕی 3

Uri.parse turns the text into a Uri object; launchUrl returns true if it opened.

Uri.parse دەقەکە دەکاتە Uri؛ launchUrl ئەگەر کردییەوە true دەگەڕێنێتەوە.

Lineدێڕی 4

If it returned false, stop with an error.

ئەگەر falseـی گەڕاندەوە، بە بوەستە.

A complete app with this function behind a button. The function is written the way the url_launcher README writes it today:

تەواو کە ئەم لە پشت . بەو شێوەیە نووسراوە کە READMEـی ⁦url_launcher⁩ ئەمڕۆ دەینووسێت:

Open flutter.dev from a buttonکردنەوەی ⁦flutter.dev⁩ لە دوگمەیەکەوەDARTRuns on a phone (or an emulator)لەسەر مۆبایل کار دەکات

import 'package:flutter/material.dart';
import 'package:url_launcher/url_launcher.dart';

void main() => runApp(const MaterialApp(home: LinksScreen()));

final Uri _website = Uri.parse('https://flutter.dev');

Future<void> _launchURL() async {
  if (!await launchUrl(_website)) {
    throw Exception('Could not launch $_website');
  }
}

class LinksScreen extends StatelessWidget {
  const LinksScreen({super.key});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Links')),
      body: const Center(
        child: ElevatedButton(
          onPressed: _launchURL,
          child: Text('Open flutter.dev'),
        ),
      ),
    );
  }
}

Explain the codeڕوونکردنەوەی کۆدەکە

Lineدێڕی 6

Build the Uri once.

Uriـەکە یەک جار دروست بکە.

Lineدێڕی 9-11

launchUrl returns Future<bool>; await gets the bool. On failure, throw an Exception, not a plain String.

launchUrl Future<bool> دەگەڕێنێتەوە؛ await بوولیانەکە وەردەگرێت. لە کاتی شکستدا Exception فڕێ بدە، نەک سادە.

Lineدێڕی 23

The button calls the function. It can be const because _launchURL is a top-level function.

بانگی دەکات. دەتوانێت const بێت چونکە _launchURL ئاستی سەرەوەیە.

Throw an Exception, not a StringException فڕێ بدە، نەک زنجیرەنووسە

The notes write throw 'Could not launch $url';. Dart allows throwing any object, but good practice (and the lint rule only_throw_errors) is to throw only objects of classes that extend Exception or Error, so catch blocks and tools can recognise them. The README writes throw Exception('Could not launch $url');.

تێبینییەکان throw 'Could not launch $url'; دەنووسن. ڕێگە بە فڕێدانی هەر دەدات، بەڵام کاری باش (و یاسای lintـی only_throw_errors) ئەوەیە تەنها ئەو فڕێ بدەیت کە لە Exception یان Errorـەوە دێن، بۆ ئەوەی بلۆکەکانی catch و ئامرازەکان بیانناسنەوە. README دەنووسێت throw Exception('Could not launch $url');.

Opening a websiteکردنەوەی تۆڕگەیەک

When nothing can open the linkکاتێک هیچ شتێک ناتوانێت بەستەرەکە بکاتەوە

Throwing an exception is fine while you develop, but in a real app it only stops your code. A user wants a message. Note also that launchUrl can fail in two ways: it can return false, or it can throw a PlatformException. Which one you get depends on the platform: on iOS a link that no app can open gives false, while on Android url_launcher 6.3 throws a PlatformException with the code ACTIVITY_NOT_FOUND instead. So catch both:

فڕێدانی لە کاتی گەشەپێداندا باشە، بەڵام لە ڕاستەقینەدا تەنها کۆدەکەت ڕادەگرێت. پەیامێکی دەوێت. هەروەها سەرنج بدە کە launchUrl بە دوو شێوە شکست دەهێنێت: دەکرێت false بگەڕێنێتەوە، یان PlatformException فڕێ بدات. کامیان ڕوو دەدات بە دەگۆڕێت: لە iOSـدا کە هیچ ناتوانێت بیکاتەوە false دەدات، بەڵام لە Androidـدا ⁦url_launcher 6.3⁩ لە جیاتی ئەوە PlatformExceptionـێک بە کۆدی ACTIVITY_NOT_FOUND فڕێ دەدات. بۆیە هەردووکیان بگرە:

A button that explains a failureدوگمەیەک کە شکست ڕوون دەکاتەوەDARTRuns on a phone (or an emulator)لەسەر مۆبایل کار دەکات

import 'package:flutter/material.dart';
import 'package:url_launcher/url_launcher.dart';

class WebsiteButton extends StatelessWidget {
  const WebsiteButton({super.key});

  Future<void> _openWebsite(BuildContext context) async {
    final url = Uri.parse('https://flutter.dev');
    bool opened;
    try {
      opened = await launchUrl(url);
    } catch (e) {
      opened = false; // some failures throw instead of returning false
    }

    if (opened || !context.mounted) return;
    ScaffoldMessenger.of(context).showSnackBar(
      SnackBar(content: Text('Could not open $url')),
    );
  }

  @override
  Widget build(BuildContext context) {
    return ElevatedButton.icon(
      onPressed: () => _openWebsite(context),
      icon: const Icon(Icons.open_in_browser),
      label: const Text('Website'),
    );
  }
}

Explain the codeڕوونکردنەوەی کۆدەکە

Lineدێڕی 9-14

try/catch turns a thrown error into false as well.

try/catch فڕێدراویش دەکاتە false.

Lineدێڕی 16

Nothing to do if it opened, or if this button is no longer on screen.

ئەگەر کرایەوە، یان ئەگەر ئەم چیتر لەسەر شاشە نییە، هیچ کارێک نییە.

Lineدێڕی 17-19

Otherwise show a SnackBar instead of crashing.

ئەگەرنا لە جیاتی تەقینەوە پیشان بدە.

SnackBars are explained in MaterialApp and Scaffold, and try/catch with await in Futures and async.

لە MaterialApp و Scaffold ڕوون کراونەتەوە و try/catch لەگەڵ await لە Futures و async.

Quick checkپشکنینی خێراOn an Android phone with no e-mail app, your code calls launchUrl with a mailto: link. What can happen?لەسەر مۆبایلێکی Android کە هیچ تێدا نییە، کۆدەکەت بانگی launchUrl بە دەکات. چی ڕوو دەدات؟It opens the browser insteadلە جیاتی ئەوە تۆڕگەڕ دەکاتەوەIt installs an e-mail appئەپێکی ئیمەیڵ دادەمەزرێنێتIt throws a PlatformException, so your code should catch itPlatformException فڕێ دەدات، بۆیە کۆدەکەت دەبێت بیگرێتIt always returns trueهەمیشە true دەگەڕێنێتەوە

Opening a websiteکردنەوەی تۆڕگەیەک

Where should the page open? Launch modesلاپەڕەکە لە کوێ بکرێتەوە؟ شێوازەکانی کردنەوە

A web page can open in the phone's browser app or inside your app. With the default mode, Android and iOS open http and https links inside your app, in a browser view (Custom Tabs on Android, SFSafariViewController on iOS). launchUrl takes a mode: to choose:

دەکرێت لە مۆبایلەکەدا یان لەناو بکرێتەوە. بە شێوازی بنەڕەتی، Android و iOS http و https لەناو دەکەنەوە، لە پیشاندەرێکی (⁦Custom Tabs⁩ لە Androidـدا، SFSafariViewController لە iOSـدا). launchUrl بۆ هەڵبژاردن mode:ـێک وەردەگرێت:

LaunchModeشێوازی LaunchMode	Where it opensلە کوێ دەکرێتەوە
`platformDefault`	The platform decides (the default). On Android and iOS: web links in an in-app browser view, other links in another app. بڕیار دەدات (بنەڕەتی). لە Android و iOSـدا: وێب لە پیشاندەرێکی لەناو ، تر لە تردا.
`externalApplication`	Another app, outside yours, such as the browser app. تر لە دەرەوەی ، وەک .
`externalNonBrowserApplication`	Another app that is not a browser, such as the YouTube app for a YouTube link. تر کە نییە، وەک YouTube بۆ YouTube.
`inAppBrowserView`	A browser view inside your app: Custom Tabs on Android, SFSafariViewController on iOS.پیشاندەرێکی لەناو : ⁦Custom Tabs⁩ لە Androidـدا، SFSafariViewController لە iOSـدا.
`inAppWebView`	A plain web view inside your app (iOS shows it like `inAppBrowserView`).WebViewـێکی سادە لەناو (iOS وەک `inAppBrowserView` پیشانی دەدات).

Choosing a modeهەڵبژاردنی شێوازێکDARTRuns on a phone (or an emulator)لەسەر مۆبایل کار دەکات

import 'package:url_launcher/url_launcher.dart';

Future<void> openInBrowser() async {
  final url = Uri.parse('https://flutter.dev');
  // Ask for the phone's own browser app, outside our app
  await launchUrl(url, mode: LaunchMode.externalApplication);
}

Future<void> openInsideApp() async {
  final url = Uri.parse('https://flutter.dev');
  // Custom Tabs (Android) or SFSafariViewController (iOS)
  await launchUrl(url, mode: LaunchMode.inAppBrowserView);
}

Explain the codeڕوونکردنەوەی کۆدەکە

Lineدێڕی 6

Leave your app and open the browser app.

جێ بهێڵە و بکەرەوە.

Lineدێڕی 12

Stay in your app, in a browser view with a Close button.

لە بمێنەرەوە، لە پیشاندەرێکی بە Close.

If a platform cannot do the mode you asked for, it falls back to one it can do, usually platformDefault. The two in-app modes accept only http and https links: any other scheme throws an ArgumentError. tel:, sms: and mailto: links always go to another app.

ئەگەر نەتوانێت ئەو شێوازە بکات کە داوات کردووە، دەگەڕێتەوە بۆ یەکێک کە دەتوانێت، زۆرجار platformDefault. هەردوو شێوازی ناو تەنها http و https وەردەگرن: هەر تر ArgumentError فڕێ دەدات. tel:، sms: و mailto: هەمیشە دەچن بۆ تر.

Quick checkپشکنینی خێراYou want a help page to open inside your app, with a Close button, using the phone's browser engine. Which mode?دەتەوێت لاپەڕەیەکی یارمەتی لەناو بکرێتەوە، بە Close، بە بزوێنەری مۆبایلەکە. کام شێواز؟LaunchMode.externalApplicationLaunchMode.externalApplicationLaunchMode.externalNonBrowserApplicationLaunchMode.externalNonBrowserApplicationA tel: linkبەستەرێکی tel:LaunchMode.inAppBrowserViewLaunchMode.inAppBrowserView

Making a phone callپەیوەندیکردنی تەلەفۆنی

url_launcher can do more than websites. The first example in the notes: the user picks a phone number in the app and calls it. The link uses the tel scheme, and the number is the path:

⁦url_launcher⁩ زیاتر لە دەکات. یەکەم نموونەی تێبینییەکان: ژمارە تەلەفۆنێک لە هەڵدەبژێرێت و پەیوەندیی پێوە دەکات. tel بەکار دەهێنێت و ژمارەکە :

The notes' codeکۆدەکەی تێبینییەکانDART

phoneCall() async{

  final Uri callURL = Uri(
    scheme: 'tel',
    path: '077210'
  );

  await launchUrl(callURL);
}

The same idea, written for today's Flutter, with a return type and an error:

هەمان بیرۆکە، نووسراو بۆ ئەمڕۆ، بە جۆری و :

A Call buttonدوگمەیەکی CallDARTRuns on a phone (or an emulator)لەسەر مۆبایل کار دەکات

import 'package:flutter/material.dart';
import 'package:url_launcher/url_launcher.dart';

Future<void> phoneCall() async {
  final Uri callUrl = Uri(scheme: 'tel', path: '07500000000');

  if (!await launchUrl(callUrl)) {
    throw Exception('Could not open the phone app for $callUrl');
  }
}

class CallButton extends StatelessWidget {
  const CallButton({super.key});

  @override
  Widget build(BuildContext context) {
    return FilledButton.icon(
      onPressed: phoneCall,
      icon: const Icon(Icons.call),
      label: const Text('Call'),
    );
  }
}

Explain the codeڕوونکردنەوەی کۆدەکە

Lineدێڕی 4

Future<void>: the notes' phoneCall() async had no return type.

Future<void>: phoneCall() asyncـی تێبینییەکان جۆری نەبوو.

Lineدێڕی 5

tel:07500000000. No // and no host: the whole number is the path.

tel:07500000000. نە // و نە : هەموو ژمارەکە .

Lineدێڕی 7-9

Tell the developer if no phone app could open it.

ئەگەر هیچ پەیوەندیکردن نەیتوانی بیکاتەوە بە بڵێ.

Animation in three frames. 1: an app screen 'Contact us' with a green Call button showing 07500000000; a finger taps it. 2: an arrow labelled launchUrl(tel:07500000000) goes to the phone's system, which chooses the phone app. 3: the phone app is open with 07500000000 typed in and a green call button; a label says the user still taps Call. — tel: opens the phone app with the number filled in; the call starts only when the user taps Call.tel: پەیوەندیکردن بە ژمارەکەوە دەکاتەوە؛ پەیوەندییەکە تەنها کاتێک دەست پێ دەکات کە دەست لە Call بدات.CêIT

No direct callپەیوەندیی ڕاستەوخۆ نییە

The notes say that the user can "make a direct call". A tel: link only opens the phone app with the number ready; the user still taps Call. An app that starts a call by itself needs the CALL_PHONE permission and its own platform code, and url_launcher does not do that. This protects users from apps that call numbers without asking.

تێبینییەکان دەڵێن دەتوانێت «ڕاستەوخۆ پەیوەندی بکات». tel: تەنها پەیوەندیکردن بە ژمارەیەکی ئامادەوە دەکاتەوە؛ خۆی دەست لە Call دەدات. کە خۆی پەیوەندی دەست پێ بکات پێویستی بە CALL_PHONE و کۆدی خۆی هەیە و ⁦url_launcher⁩ ئەمە ناکات. ئەمە لەو دەپارێزێت کە بەبێ پرسیار پەیوەندی بە ژمارەکانەوە دەکەن.

Quick checkپشکنینی خێراThe user taps your Call button. What happens? دەست لە Callـی تۆ دەدات. چی ڕوو دەدات؟The call starts at once, without the phone appپەیوەندییەکە یەکسەر دەست پێ دەکات، بەبێ ئەپی پەیوەندیکردنThe phone app opens with the number filled in; the user taps Call to startئەپی پەیوەندیکردن بە ژمارەکەوە دەکرێتەوە؛ بەکارهێنەر بۆ دەستپێکردن دەست لە Call دەداتAn SMS is sent to the numberنامەیەکی کورت بۆ ژمارەکە دەنێردرێتThe number is saved in Contactsژمارەکە لە Contactsـدا پاشەکەوت دەکرێت

SMS, e-mail and the other schemesنامەی کورت، ئیمەیڵ و سکیمەکانی تر

The notes list two more launchers: send an SMS, where the user sends a message to a number, and send an e-mail, where the user chooses whom to write to, enters a subject and a body, and sends it. The url_launcher README lists the schemes it supports:

تێبینییەکان دوو کردنەوەی تر ڕیز دەکەن: ناردنی ، کە نامەیەک بۆ ژمارەیەک دەنێرێت؛ هەروەها ناردنی ، کە هەڵدەبژێرێت بۆ کێ بنووسێت، بابەت و دەقێک دەنووسێت و دەینێرێت. READMEـی ⁦url_launcher⁩ ئەو ڕیز دەکات کە پشتگیرییان دەکات:

Schemes url_launcher supports (they work only if the phone has an app for them) پشتگیریکراوی ⁦url_launcher⁩ (تەنها ئەگەر مۆبایلەکە بۆیان هەبێت کار دەکەن)
Scheme	Exampleنموونە	What opensچی دەکرێتەوە
`https:`	`https://flutter.dev`	The browser
`mailto:`	`mailto:teacher@example.com?subject=News&body=Hello`	A new e-mail in the e-mail app نوێ لە
`tel:`	`tel:07500000000`	The phone app, ready to call پەیوەندیکردن، ئامادە بۆ پەیوەندی
`sms:`	`sms:07500000000`	The messaging app نامەکان
`file:`	`file:/home`	A file or folder with its default app (desktop only) یان بە بنەڕەتییەکەی (تەنها ڕوومێز)

An SMS or e-mail link with text inside it (?body=…, ?subject=…) must be percent-encoded correctly, and the course's own examples get this wrong in a subtle way. That is the whole next lesson: Building URIs in Dart: SMS and e-mail links.

یان کە دەقی تێدایە (?body=…، ?subject=…) دەبێت بە دروستی بە بنووسرێت و نموونەکانی خودی وانەکە لەمەدا هەڵەیەکی ورد دەکەن. ئەمە هەموو وانەی داهاتووە: دروستکردنی URI لە Dartـدا: بەستەرەکانی نامەی کورت و ئیمەیڵ.

Android and iOS settings: when are they needed?ڕێکخستنەکانی Android و iOS: کەی پێویستن؟

Sometimes an app wants to know before the tap whether a link can open, for example to hide an SMS button on a tablet with no SMS app. url_launcher has canLaunchUrl(uri) for this. But phones protect their users' privacy: an app may not freely look at which other apps are installed. So for canLaunchUrl you must declare, in each platform's manifest, which kinds of links you will ask about. The notes show both files:

هەندێک جار دەیەوێت پێش دەستلێدان بزانێت ئایا دەکرێتەوە، بۆ نموونە بۆ شاردنەوەی لەسەر تابلێتێک کە نییە. ⁦url_launcher⁩ بۆ ئەمە canLaunchUrl(uri)ـی هەیە. بەڵام مۆبایلەکان دەپارێزن: ناتوانێت بە ئازادی سەیری ئەوە بکات کە کام تر دامەزراون. بۆیە بۆ canLaunchUrl دەبێت لە هەر ڕابگەیەنیت کە پرسیار دەربارەی کام جۆرە دەکەیت. تێبینییەکان هەردوو پیشان دەدەن:

Android: the notes' <queries> blockAndroid: بلۆکی ⁦<queries>⁩ـی تێبینییەکانandroid/app/src/main/AndroidManifest.xmlXML

<queries>
    <!-- If your app opens https URLs -->
    <intent>
        <action android:name="android.intent.action.VIEW"/>
        <data android:scheme="https"/>
    </intent>
    <!-- If your app makes calls -->
    <intent>
        <action android:name="android.intent.action.DIAL"/>
        <data android:scheme="tel"/>
    </intent>
    <!-- If your sends SMS messages -->
    <intent>
        <action android:name="android.intent.action.SENDTO"/>
        <data android:scheme="smsto"/>
    </intent>
    <!-- If your app sends emails -->
    <intent>
        <action android:name="android.intent.action.SEND"/>
        <data android:mimetype="*/*"/>
    </intent>
</queries>

iOS: the notes' LSApplicationQueriesSchemes⁦iOS: LSApplicationQueriesSchemes⁩ـی تێبینییەکانios/Runner/Info.plistXML

<key>LSApplicationQueriesSchemes</key>
<array>
    <string>https</string>
    <string>http</string>
    <string>tel</string>
    <string>mailto</string>
</array>

Fixing the notes' configurationچاککردنی ڕێکخستنەکانی تێبینییەکان

android:mimetype must be android:mimeType: XML attribute names are case-sensitive.
The notes' entries for calls, SMS and e-mail use the DIAL, SENDTO (smsto) and SEND actions. url_launcher checks every link with the VIEW action, and its README uses VIEW with the tel and sms schemes; follow the README.
The iOS folder is ios/Runner/Info.plist (lower-case ios). If you check sms: links on iOS, add <string>sms</string> too; the notes' list has no sms.
Small slip in a comment: "If your sends SMS messages" means "If your app sends SMS messages".

android:mimetype دەبێت android:mimeType بێت: ناوی تایبەتمەندییەکانی XML هەستیارن بە پیتی گەورە و بچووک.
تۆمارەکانی تێبینییەکان بۆ پەیوەندی، و actionـەکانی DIAL، SENDTO (smsto) و SEND بەکار دەهێنن. ⁦url_launcher⁩ هەموو بە actionـی VIEW دەپشکنێت و READMEـەکەی VIEW لەگەڵ tel و sms بەکار دەهێنێت؛ شوێن README بکەوە.
iOS ios/Runner/Info.plistـە (ios بە پیتی بچووک). ئەگەر sms: لە iOSـدا دەپشکنیت، <string>sms</string>ـیش زیاد بکە؛ لیستەکەی تێبینییەکان smsـی تێدا نییە.
هەڵەیەکی بچووک لە : «⁦If your sends SMS messages⁩» واتە «⁦If your app sends SMS messages⁩».

Quick checkپشکنینی خێراWhy must an app declare in its manifest the kinds of link it will check?بۆچی دەبێت لە ئەو جۆرە ڕابگەیەنێت کە دەیانپشکنێت؟Because launchUrl never works without themچونکە launchUrl بەبێ ئەوان هەرگیز کار ناکاتSo the phone installs the apps it needsبۆ ئەوەی مۆبایلەکە ئەو ئەپانە دابمەزرێنێت کە پێویستیەتیPhones keep the list of installed apps private; an app may ask only about what it declaredمۆبایلەکان لیستی ئەپەکانی دامەزراو بە نهێنی دەهێڵنەوە؛ ئەپێک تەنها دەتوانێت دەربارەی ئەوە بپرسێت کە ڕایگەیاندووەTo make links open fasterبۆ ئەوەی بەستەرەکان خێراتر بکرێنەوە

Android and iOS settings: when are they needed?ڕێکخستنەکانی Android و iOS: کەی پێویستن؟

What url_launcher needs today⁦url_launcher⁩ ئەمڕۆ چی پێویستە

Android 11 (API 30) and newer hides other apps from yours unless the manifest's <queries> element (a child of <manifest>, not of <application>) names the kinds of link you check. Without it, canLaunchUrl usually returns false.
iOS needs every scheme you pass to canLaunchUrl in LSApplicationQueriesSchemes in Info.plist; otherwise it returns false.
launchUrl itself does not need these entries. Android's documentation says that starting another app's activity, including opening a URL, needs no <queries>. If your app simply calls launchUrl and handles a failure, you can leave the files alone.

⁦Android 11 (API 30)⁩ و نوێتر تر لە دەشارێتەوە مەگەر توخمی <queries>ـی (منداڵی <manifest>، نەک <application>) ئەو جۆرە ناو ببات کە دەیانپشکنیت. بەبێ ئەو، canLaunchUrl زۆرجار false دەگەڕێنێتەوە.
iOS پێویستی بە هەموو ئەو هەیە کە دەیدەیتە canLaunchUrl لە LSApplicationQueriesSchemesـی Info.plistـدا؛ ئەگەرنا false دەگەڕێنێتەوە.
خودی launchUrl پێویستی بەم تۆمارانە نییە. بەڵگەنامەکانی Android دەڵێن دەستپێکردنی چالاکییەکی تر، لەوانە کردنەوەی ، هیچ <queries>ـێکی ناوێت. ئەگەر تەنها بانگی launchUrl دەکات و مامەڵە لەگەڵ شکست دەکات، دەتوانیت وەک خۆیان بهێڵیتەوە.

Android: entries that match how url_launcher checks linksAndroid: ئەو تۆمارانەی لەگەڵ شێوازی پشکنینی ⁦url_launcher⁩ـدا دەگونجێنandroid/app/src/main/AndroidManifest.xmlXML

<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <queries>
        <!-- If your app checks for https support -->
        <intent>
            <action android:name="android.intent.action.VIEW" />
            <data android:scheme="https" />
        </intent>
        <!-- If your app checks for call support -->
        <intent>
            <action android:name="android.intent.action.VIEW" />
            <data android:scheme="tel" />
        </intent>
        <!-- If your app checks for SMS support -->
        <intent>
            <action android:name="android.intent.action.VIEW" />
            <data android:scheme="sms" />
        </intent>
        <!-- If your app checks for e-mail support -->
        <intent>
            <action android:name="android.intent.action.VIEW" />
            <data android:scheme="mailto" />
        </intent>
    </queries>
    <application ...>
        ...
    </application>
</manifest>

Explain the codeڕوونکردنەوەی کۆدەکە

Lineدێڕی 2

<queries> sits directly inside <manifest>, before <application>.

<queries> ڕاستەوخۆ لەناو <manifest>ـدایە، پێش <application>.

Lineدێڕی 5-6

url_launcher checks a link with the VIEW action, so each entry uses VIEW and the link's scheme.

⁦url_launcher⁩ بە actionـی VIEW دەپشکنێت، بۆیە هەر تۆمارێک VIEW و بەکار دەهێنێت.

Quick checkپشکنینی خێراYour app only calls launchUrl for an https link and catches failures. Does it need a <queries> entry on Android? تەنها بانگی launchUrl بۆ https دەکات و شکستەکان دەگرێت. لە Androidـدا پێویستی بە تۆمارێکی <queries> هەیە؟Only on iOSتەنها لە iOSـداNo: <queries> is needed for canLaunchUrl, not for launchingنەخێر: <queries> بۆ canLaunchUrl پێویستە، نەک بۆ کردنەوەYes, plus the CALL_PHONE permissionبەڵێ، لەگەڵ مۆڵەتی ئەپی ⁦CALL_PHONE⁩Yes: every link needs oneبەڵێ: هەموو بەستەرێک پێویستی پێیەتی

Android and iOS settings: when are they needed?ڕێکخستنەکانی Android و iOS: کەی پێویستن؟

canLaunchUrl in codecanLaunchUrl لە کۆددا

With the entries in place, canLaunchUrl can answer. This button asks once, when it appears, and hides itself if no app can send an SMS:

کاتێک تۆمارەکان هەبن، canLaunchUrl دەتوانێت وەڵام بداتەوە. ئەم کاتێک دەردەکەوێت یەک جار پرسیار دەکات و ئەگەر هیچ نەتوانێت بنێرێت خۆی دەشارێتەوە:

canLaunchUrl: show the button only if SMS can workcanLaunchUrl: دوگمەکە تەنها ئەگەر نامەی کورت کار بکات پیشان بدەDARTRuns on a phone (or an emulator)لەسەر مۆبایل کار دەکات

import 'package:flutter/material.dart';
import 'package:url_launcher/url_launcher.dart';

class SmsButton extends StatefulWidget {
  const SmsButton({super.key});

  @override
  State<SmsButton> createState() => _SmsButtonState();
}

class _SmsButtonState extends State<SmsButton> {
  final Uri _sms = Uri(scheme: 'sms', path: '07500000000');
  bool _canSendSms = false;

  @override
  void initState() {
    super.initState();
    _check();
  }

  Future<void> _check() async {
    // Needs <queries> (Android) and LSApplicationQueriesSchemes (iOS)
    final bool result = await canLaunchUrl(_sms);
    if (!mounted) return;
    setState(() => _canSendSms = result);
  }

  @override
  Widget build(BuildContext context) {
    if (!_canSendSms) return const SizedBox.shrink(); // hide the button
    return OutlinedButton(
      onPressed: () => launchUrl(_sms),
      child: const Text('Send SMS'),
    );
  }
}

Explain the codeڕوونکردنەوەی کۆدەکە

Lineدێڕی 21-26

Ask once, when the widget appears. Remember the answer with setState.

یەک جار پرسیار بکە، کاتێک دەردەکەوێت. وەڵامەکە بە setState لەبیر بکە.

Lineدێڕی 30

Hide the button when no app can send SMS.

کاتێک هیچ ناتوانێت بنێرێت بشارەوە.

Prefer trying over askingهەوڵدان باشترە لە پرسیارکردن

canLaunchUrl can return false even when launchUrl would work, for example in a web app, or on a phone whose manifest entries are missing. When you have a fallback, the README advises calling launchUrl directly and handling the failure, for example opening a web form if the mailto: link fails.

canLaunchUrl دەکرێت false بگەڕێنێتەوە تەنانەت کاتێک launchUrl کار دەکات، بۆ نموونە لە ، یان لەسەر مۆبایلێک کە تۆمارەکانی کەمن. کاتێک ڕێگایەکی جێگرەوەت هەیە، README پێشنیار دەکات ڕاستەوخۆ بانگی launchUrl بکەیت و مامەڵە لەگەڵ شکست بکەیت، بۆ نموونە ئەگەر شکستی هێنا فۆرمێکی وێب بکەرەوە.

Quick checkپشکنینی خێراYour feedback button uses a mailto: link, and you could open a web form instead if it fails. What does the url_launcher README advise? ڕاوبۆچوونەکەت بەکار دەهێنێت و دەتوانیت ئەگەر شکستی هێنا لە جیاتی ئەوە فۆرمێکی وێب بکەیتەوە. READMEـی ⁦url_launcher⁩ چی پێشنیار دەکات؟Hide the button whenever canLaunchUrl returns falseهەر کاتێک canLaunchUrl falseـی گەڕاندەوە دوگمەکە بشارەوەCall launchUrl directly and open the web form if it failsڕاستەوخۆ بانگی launchUrl بکە و ئەگەر شکستی هێنا فۆرمە وێبییەکە بکەرەوەUse a tel: link insteadلە جیاتی ئەوە بەستەرێکی tel: بەکار بهێنەNever handle failuresهەرگیز مامەڵە لەگەڵ شکست مەکە

Common mistakesهەڵە باوەکان

Mistakeهەڵە	What happensچی ڕوو دەدات	Fixچاککردن
Hot reload after adding url_launcher دوای زیادکردنی ⁦url_launcher⁩	`MissingPluginExceptionMissingPluginException`	Stop the app and run it again ڕابگرە و دووبارە کاری پێ بکەرەوە
Only checking the `bool` from `launchUrl`تەنها پشکنینی `bool`ـی `launchUrl`	A `PlatformException` on Android when no app handles the link`PlatformException` لە Androidـدا کاتێک هیچ کار بە ناکات	Wrap it in `try`/`catch` and show a messageبیخە ناو `try`/`catch` و پەیامێک پیشان بدە
`throw 'Could not launch $url';throw 'Could not launch $url';`	A String is thrown; catch blocks and tools expect exceptions فڕێ دەدرێت؛ بلۆکەکانی catch و ئامرازەکان چاوەڕێی دەکەن	`throw Exception('Could not launch $url');throw Exception('Could not launch $url');`
`canLaunchUrl` without manifest entries`canLaunchUrl` بەبێ تۆماری	It returns `false`, so the button never shows`false` دەگەڕێنێتەوە، بۆیە هەرگیز دەرناکەوێت	Add `<queries>` (Android) and `LSApplicationQueriesSchemes` (iOS), or just try `launchUrl<queries>` ⁦(Android)⁩ و `LSApplicationQueriesSchemes` ⁦(iOS)⁩ زیاد بکە، یان تەنها `launchUrl` تاقی بکەرەوە
`<queries>` inside `<application><queries>` لەناو `<application>`ـدا	Ignoredپشتگوێ دەخرێت	Put it directly inside `<manifest>`ڕاستەوخۆ بیخە ناو `<manifest>`
Testing `tel:` or `mailto:` on the iOS Simulatorتاقیکردنەوەی `tel:` یان `mailto:` لەسەر iOS	Nothing opensهیچ شتێک ناکرێتەوە	Test on a real phoneلەسەر مۆبایلێکی ڕاستەقینە تاقی بکەرەوە
Expecting `tel:` to call by itselfچاوەڕوانیی ئەوەی `tel:` خۆی پەیوەندی بکات	The phone app opens and waits پەیوەندیکردن دەکرێتەوە و چاوەڕێ دەکات	This is correct behaviour: the user taps Callئەمە هەڵسوکەوتی دروستە: دەست لە Call دەدات

Exercisesڕاهێنانەکان

Exerciseڕاهێنان1. Add the plugin١. پاشکۆکە زیاد بکە

Write the three things you do, in order, to use url_launcher in a new project.

ئەو سێ شتەی دەیکەیت، بە ڕیز، بنووسە بۆ بەکارهێنانی ⁦url_launcher⁩ لە پڕۆژەیەکی نوێدا.

Show answerوەڵامەکە پیشان بدە

Run flutter pub add url_launcher (it adds url_launcher: ^6.3.3 to pubspec.yaml).
Add import 'package:url_launcher/url_launcher.dart'; to the Dart file.
Stop the app and run it again (a plugin needs a full build).

flutter pub add url_launcher جێبەجێ بکە (url_launcher: ^6.3.3 بۆ pubspec.yaml زیاد دەکات).
import 'package:url_launcher/url_launcher.dart'; بۆ زیاد بکە.
ڕابگرە و دووبارە کاری پێ بکەرەوە ( پێویستی بە تەواو هەیە).

Exerciseڕاهێنان2. A website button٢. دوگمەیەکی تۆڕگە

Write a function openCourseSite() that opens https://www.example.com/courses in the phone's browser app (not inside your app) and throws an Exception if it fails.

openCourseSite() بنووسە کە https://www.example.com/courses لە مۆبایلەکەدا (نەک لەناو ) بکاتەوە و ئەگەر شکستی هێنا Exceptionـێک فڕێ بدات.

Show answerوەڵامەکە پیشان بدە

DART

Future<void> openCourseSite() async {
  final url = Uri.parse('https://www.example.com/courses');
  if (!await launchUrl(url, mode: LaunchMode.externalApplication)) {
    throw Exception('Could not launch $url');
  }
}

Exerciseڕاهێنان3. Call the office٣. پەیوەندی بە نووسینگەکەوە بکە

Fix the notes' phoneCall for today's Dart: give it a return type, use the number 07500000000, and report a failure.

phoneCallـی تێبینییەکان بۆ ئەمڕۆ چاک بکە: جۆری بدەرێ، ژمارەی 07500000000 بەکار بهێنە و شکست ڕابگەیەنە.

Show answerوەڵامەکە پیشان بدە

DART

Future<void> phoneCall() async {
  final Uri callUrl = Uri(scheme: 'tel', path: '07500000000');
  if (!await launchUrl(callUrl)) {
    throw Exception('Could not open the phone app for $callUrl');
  }
}

The Uri is tel:07500000000. The phone app opens with the number; the user taps Call.

tel:07500000000ـە. پەیوەندیکردن بە ژمارەکەوە دەکرێتەوە؛ دەست لە Call دەدات.

Exerciseڕاهێنان4. Correct the manifest٤. مانیفێستی ئەپەکە ڕاست بکەرەوە

Your app shows a Call button only if canLaunchUrl(Uri(scheme: 'tel', path: '1')) is true, on Android and iOS. Write the Android <queries> entry and the iOS Info.plist entry it needs.

Call تەنها کاتێک پیشان دەدات کە canLaunchUrl(Uri(scheme: 'tel', path: '1')) ڕاست بێت، لە Android و iOSـدا. ئەو تۆمارەی <queries>ـی Android و تۆماری Info.plistـی iOS بنووسە کە پێویستیەتی.

Show answerوەڵامەکە پیشان بدە

XML

<!-- AndroidManifest.xml, inside <manifest> -->
<queries>
    <intent>
        <action android:name="android.intent.action.VIEW" />
        <data android:scheme="tel" />
    </intent>
</queries>

XML

<!-- ios/Runner/Info.plist -->
<key>LSApplicationQueriesSchemes</key>
<array>
    <string>tel</string>
</array>

Exerciseڕاهێنان5. Which scheme?٥. کام سکیم؟

Write a link for each: (a) open the website www.example.com; (b) open the phone app with 07500000000; (c) open Messages to 07500000000 with no text; (d) start an e-mail to office@example.com.

بۆ هەر یەکێک بنووسە: (أ) کردنەوەی www.example.com؛ (ب) کردنەوەی پەیوەندیکردن بە 07500000000ـەوە؛ (ج) کردنەوەی نامەکان بۆ 07500000000 بەبێ دەق؛ (د) دەستپێکردنی بۆ office@example.com.

Show answerوەڵامەکە پیشان بدە

(a) https://www.example.com
(b) tel:07500000000
(c) sms:07500000000
(d) mailto:office@example.com

(أ) https://www.example.com
(ب) tel:07500000000
(ج) sms:07500000000
(د) mailto:office@example.com

Quick checkپشکنینی خێراWhat does canLaunchUrl tell you?canLaunchUrl چیت پێ دەڵێت؟Whether an app on the phone is likely to handle the link, if the manifest entries are thereئایا ئەپێک لەسەر مۆبایلەکە ئەگەری هەیە کار بە بەستەرەکە بکات، ئەگەر تۆمارەکانی مانیفێستی ئەپ هەبنWhether the user has internetئایا بەکارهێنەرەکە ئینتەرنێتی هەیەWhether the phone number existsئایا ژمارە تەلەفۆنەکە بوونی هەیەWhether the website is onlineئایا تۆڕگەکە ئۆنلاینە

Summaryپوختە

url_launcher (6.3.3) is a plugin: a package with Android and iOS code. Add it with flutter pub add url_launcher, import package:url_launcher/url_launcher.dart, and restart the app.
launchUrl(uri) hands a URI to the operating system, which opens the app for its scheme: https: browser, tel: phone, sms: messages, mailto: e-mail.
It returns Future<bool>; it can also throw PlatformException. Handle both and show the user a message.
mode: chooses where web pages open (externalApplication, inAppBrowserView…).
A tel: link fills in the number; the user still taps Call.
<queries> (Android 11+) and LSApplicationQueriesSchemes (iOS) are needed only for canLaunchUrl.

⁦url_launcher (6.3.3)⁩ : بە کۆدی Android و iOSـەوە. بە flutter pub add url_launcher زیادی بکە، package:url_launcher/url_launcher.dart import بکە و دووبارە دەست پێ بکەرەوە.
launchUrl(uri) دەداتە ، کە دەکاتەوە: https: ، tel: پەیوەندیکردن، sms: نامەکان، mailto: .
Future<bool> دەگەڕێنێتەوە؛ دەشتوانێت PlatformException فڕێ بدات. مامەڵە لەگەڵ هەردووکیان بکە و پەیامێک بە پیشان بدە.
mode: هەڵدەبژێرێت لە کوێ بکرێنەوە (externalApplication، inAppBrowserView…).
tel: ژمارەکە دەنووسێت؛ هێشتا خۆی دەست لە Call دەدات.
<queries> ⁦(Android 11+)⁩ و LSApplicationQueriesSchemes ⁦(iOS)⁩ تەنها بۆ canLaunchUrl پێویستن.

Review questionsپرسیارەکانی پێداچوونەوە

Why is url_launcher called a plugin and not just a package?بۆچی بە ⁦url_launcher⁩ دەوترێت پاشکۆ نەک تەنها کتێبخانە؟

Because it contains platform code (Kotlin/Java and Swift/Objective-C) to talk to Android and iOS.

چونکە کۆدی (⁦Kotlin/Java⁩ و ⁦Swift/Objective-C⁩) تێدایە بۆ قسەکردن لەگەڵ Android و iOS.

Does a tel: link start the call?ئایا بەستەرێکی tel: پەیوەندییەکە دەست پێ دەکات؟

No. It opens the phone app with the number; the user decides and taps Call.

نەخێر. پەیوەندیکردن بە ژمارەکەوە دەکاتەوە؛ بڕیار دەدات و دەست لە Call دەدات.

When do you need <queries> in AndroidManifest.xml?کەی پێویستت بە <queries> لە ⁦AndroidManifest.xml⁩ـدا هەیە؟

When your app calls canLaunchUrl on Android 11 or newer. Plain launchUrl does not need it.

کاتێک لەسەر ⁦Android 11⁩ یان نوێتر بانگی canLaunchUrl دەکات. launchUrlـی سادە پێویستی پێی نییە.

Videoڤیدیۆ

Watch a videoسەیری ڤیدیۆیەک بکە

A video that viewers liked a lot and praised in their comments, chosen for this lesson.ڤیدیۆیەک کە بینەران زۆریان پێ خۆش بووە و لە کۆمێنتەکانیاندا ستایشیان کردووە، بۆ ئەم وانەیە هەڵبژێردراوە.

8. LaunchUrl in Flutter (Central Kurdish)Aland Kawa Ali · Kurdish (Sorani)کوردی (سۆرانی) · 909 viewsبینین · 12 likesلایک
In Central Kurdish, by CêIT's author: url_launcher in a Flutter app: opening a website, a phone call, an e-mail and an SMS with launchUrl.
بە کوردیی ناوەندی، لەلایەن نووسەری CêITـەوە: ⁦url_launcher⁩ لە — کردنەوەی ، پەیوەندییەکی تەلەفۆنی، و بە launchUrl.
Whole video (12:22): the buttons of this lesson (a website, a call, an e-mail and an SMS) built step by step with launchUrl on an Android emulator.
هەموو ڤیدیۆکە ⁦(12:22)⁩: ئەم وانەیە — ، پەیوەندیی تەلەفۆنی، و — هەنگاو بە هەنگاو بە launchUrl لەسەر Android دروست دەکرێن.

Lesson complete!وانەکە تەواو بوو!

Well done. Review the key terms, then go on to the next lesson.دەستخۆش. سەیرێکی زاراوە سەرەکییەکان بکەرەوە، پاشان بڕۆ بۆ وانەی داهاتوو.

Key termsزاراوە سەرەکییەکان

Next lessonوانەی داهاتوو

Building URIs in Dart: SMS and E-mail Linksدروستکردنی URI لە Dartـدا: بەستەرەکانی نامەی کورت و ئیمەیڵ

Related lecturesوانە پەیوەندیدارەکان

References and further readingسەرچاوەکان و خوێندنەوەی زیاتر

This lecture is a first edition. The Kurdish text and terminology are waiting for review by Kurdish IT teachers.ئەم وانەیە چاپی یەکەمە. دەقە کوردییەکە و زاراوەکانی چاوەڕێی پێداچوونەوەی مامۆستایانی کوردی بواری IT ن.