Linking¶

Linking предоставляет вам общий интерфейс для взаимодействия с входящими и исходящими ссылками приложений.

Каждая ссылка (URL) имеет схему URL, некоторые сайты имеют префикс https:// или http://, а http является схемой URL. Для краткости будем называть ее схемой.

Помимо https, вы, скорее всего, знакомы со схемой mailto. Когда вы открываете ссылку со схемой mailto, ваша операционная система открывает установленное почтовое приложение. Аналогично существуют схемы для совершения телефонных звонков и отправки SMS.

Подобно использованию схемы mailto, можно ссылаться на другие приложения, используя пользовательские схемы url. Например, когда вы получаете письмо Magic Link от Slack, кнопка Launch Slack представляет собой тег якоря с href, который выглядит примерно так: slack://secret/magic-login/other-secret. Как и в случае со Slack, вы можете указать операционной системе, что хотите работать с пользовательской схемой. Когда приложение Slack открывается, оно получает URL-адрес, который был использован для его открытия. Это часто называют глубоким связыванием.

Пользовательская схема URL — это не единственный способ открыть ваше приложение на мобильном устройстве. Вы не хотите использовать пользовательскую схему URL в ссылках в письме, потому что тогда ссылки будут нерабочими на рабочем столе. Вместо этого вы хотите использовать обычные ссылки https, например https://www.myapp.io/records/1234546. И на мобильном телефоне вы хотите, чтобы эта ссылка открывала ваше приложение. В Android это называется Deep Links (Universal Links — iOS).

Встроенные схемы URL¶

Как уже упоминалось во введении, существуют некоторые схемы URL для основной функциональности, которые существуют на каждой платформе. Приведенный ниже список не является исчерпывающим, но охватывает наиболее часто используемые схемы.

Включение глубоких ссылок¶

Если вы хотите включить глубокие ссылки в своем приложении, ознакомьтесь с приведенным ниже руководством:

1
2
3

<activity
    android:name=".MainActivity"
    android:launchMode="singleTask">

1
2
3
4
5
6
7
8
9

// iOS 9.x or newer
#import <React/RCTLinkingManager.h>

- (BOOL)application:(UIApplication *)application
openURL:(NSURL *)url
options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options
{
return [RCTLinkingManager application:application openURL:url options:options];
}

1
2
3
4
5
6
7
8
9

// iOS 8.x or older
#import <React/RCTLinkingManager.h>

- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url
sourceApplication:(NSString *)sourceApplication annotation:(id)annotation
{
return [RCTLinkingManager application:application openURL:url
                    sourceApplication:sourceApplication annotation:annotation];
}

1
2
3
4
5
6
7

- (BOOL)application:(UIApplication *)application continueUserActivity:(nonnull NSUserActivity *)userActivity
restorationHandler:(nonnull void (^)(NSArray<id<UIUserActivityRestoring>> * _Nullable))restorationHandler
{
return [RCTLinkingManager application:application
                continueUserActivity:userActivity
                    restorationHandler:restorationHandler];
}

Работа с глубокими ссылками¶

Существует два способа обработки URL-адресов, открывающих ваше приложение.

1. Если приложение уже открыто, оно переводится на передний план и запускается событие Linking 'url'¶

Вы можете обрабатывать эти события с помощью Linking.addEventListener('url', callback) — он вызывает callback({url}) с URL ссылки

2. Если приложение еще не открыто, оно открывается, и в качестве начальногоURL передается url¶

Вы можете обрабатывать эти события с помощью Linking.getInitialURL() — он возвращает Promise, который разрешается в URL, если он есть.

Пример¶

Открытые ссылки и глубокие ссылки (универсальные ссылки)¶

Открыть пользовательские настройки¶

Получить глубокую ссылку¶

Отправка интенций (Android)¶

Методы¶

addEventListener()¶

1
2
3
4

static addEventListener(
  type: 'url',
  handler: (event: {url: string}) => void,
): EmitterSubscription;

Добавьте обработчик изменений Linking, прослушивая тип события url и предоставляя обработчик.

canOpenURL()¶

1

static canOpenURL(url: string): Promise<boolean>;

Определите, может ли установленное приложение обрабатывать заданный URL.

Метод возвращает объект Promise. Когда определяется, можно ли обрабатывать данный URL, обещание разрешается, и первым параметром является то, можно ли его открыть.

Обещание Promise будет отклонено на Android, если невозможно проверить, можно ли открыть URL, или при работе с Android 11 (SDK 30), если вы не указали соответствующие запросы намерения в AndroidManifest.xml. Аналогично на iOS обещание будет отклонено, если вы не добавили конкретную схему в ключ LSApplicationQueriesSchemes в Info.plist (см. ниже).

Параметры:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

<manifest>
    <queries>
        <intent>
            <action
                android:name="android.intent.action.VIEW"
            />
            <data android:scheme="https" />
        </intent>
    </queries>
</manifest>

getInitialURL()¶

1

static getInitialURL(): Promise<string | null>;

Если запуск приложения был инициирован ссылкой на приложение, будет указан url ссылки, в противном случае будет указан null.

openSettings()¶

1

static openSettings(): Promise<void>;

Откройте приложение "Настройки" и отобразите пользовательские настройки приложения, если они есть.

openURL()¶

1

static openURL(url: string): Promise<any>;

Попробуйте открыть заданный url с помощью любого из установленных приложений.

Вы можете использовать другие URL, например, местоположение (например, "geo:37.484847,-122.148386" на Android или "http://maps.apple.com/?ll=37.484847,-122.148386" на iOS), контакт или любой другой URL, который можно открыть с помощью установленных приложений.

Метод возвращает объект Promise. Если пользователь подтверждает диалог открытия или url открывается автоматически, обещание выполняется. Если пользователь отменяет открытый диалог или для url нет зарегистрированных приложений, обещание отклоняется.

Параметры:

sendIntent() ¶

1
2
3
4

static sendIntent(
  action: string,
  extras?: Array<{key: string; value: string | number | boolean}>,
): Promise<void>;

Запустите намерение Android с помощью дополнительных функций.

Параметры:

Комментарии