Гиперсвязь за пределами Интернета | CSS-Tricks

   CFBundleURLTypes 

  
     CFBundleURLSchemes 
    
       CSS-уловок 
    
  
  

Для MacOS вы получите призывы к AppDelegate где вы можете отменить функцию:

  func application (_ application: NSApplication, open urls: [URL]) {
  // Выберите первый URL в списке URL для открытия
  let url = urls [0];
  // Зарегистрировать весь URL
  NSLog ("% @", url.absoluteString)
}  

  - (void) приложение: (NSApplication *) application openURLs: (NSArray  *) urls {
  NSLog (@ "% @", URL [0] .absoluteString);
}  

В iOS, функция получения того же вызова в AppDelegate :

  func application (_ app: UIApplication, open url: URL, options: [UIApplicationOpenURLOptionsKey : Any] = [:]) -> Bool {
  NSLog ("% @", url.absoluteString)
  return true
}  

  - (BOOL) приложение: (UIApplication *) app openURL: (NSURL *) Параметры URL: (NSDictionary  *) options {
  NSLog (@ "% @", url.absoluteString);
  return true;
}  

Тип URL во всех этих случаях содержит обычные URL-фрагменты, такие как путь, запрос и параметры поиска.

Универсальные ссылки

Универсальные ссылки не поддерживаются в MacOS. Чтобы получить универсальные ссылки на iOS, вам необходимо зарегистрироваться в Программе разработчиков Apple или стать членом программы Enterprise Developer Enterprise. Универсальные ссылки на iOS являются частью более широкой концепции связанных доменов, где секреты веб-сайта, такие как хранимые учетные данные, могут быть доступны из приложения, и Apple не позволяет обычным пользователям Xcode избегать универсальных ссылок (если вы случайно включите для вашего идентификатора приложения, но не помещайте это в права, будьте готовы получить ошибку проверки: ERROR ITMS-90046: «Недопустимые права подписи кода»).

Trivia! Универсальные ссылки - это новая концепция, и многие настольные приложения Mac и Windows построены со своим сетевым стеком, не используют хранилище приложений и, возможно, были выпущены много лет назад. Поэтому ОС не имеет контроля, необходимого для принудительного применения всеми приложениями концепции Universal link и открытия приложения. Apple предпочла не реализовывать Universal Links в MacOS, но в Windows они работают только в браузере Microsoft Edge и других приложениях UWP (которые используют ту же технологию).

Чтобы зарегистрироваться для универсальных ссылок на iOS, вам нужно сделать следующее:

1. Включите идентификатор приложения на веб-сайте Apple Developer, чтобы получить эту функцию для связанных доменов.
2. Добавьте связанные домены в файл с правами.
3. Добавить файл apple-app-site-association в веб-домен для подтверждения прав собственности на приложение.
4. Добавить код для обработки кликов по универсальным ссылкам.

Шаги 1 и 2 можно выполнить вместе на вкладке «Возможности» на Xcode, если вы вошли в систему и выбрали правильный профиль (который принадлежит учетной записи Apple Developer или Enterprise). Пользовательский интерфейс Xcode показывает, что оба элемента были завершены.

На изображении выше, этап 2 успешно завершен, а этап 1 находится на рассмотрении. Вы можете щелкнуть по восклицательному знаку, чтобы найти проблему. Важно префикс домена с помощью приложений : (который определяет, что вам нужны функции ссылок на приложения, то же самое используется для общих учетных данных). Это означает, что функция подключения приложений включена.

Вышеупомянутые шаги также могут быть выполнены индивидуально.

Для шага 1 включите Associated Domains в разделе App ID на веб-сайте разработчика (показано в нижней части изображения):

Для шага 2 добавьте следующее в файл прав:

   com.apple.developer.associated-domains 

   applinks: css-tricks.com 
  

Теперь, для шага 3, разместите файл ассоциации apple-app-site-association как https://css-tricks.com/apple-app-site-association с типом mime application / json со следующими данными JSON от корня вашего сайта:

  {
  "applinks": {
    «apps»: [],
    "Детали": {
      "ABCDEFGHIJ.com.ccs-tricks.mobile": {
        «пути»: [
          "*"
        ]
      }
    }
  }
}  

Вышеприведенный фрагмент предоставляет приложение с ID ABCDEFGHIJ.com.ccs-tricks.mobile и обеспечивает доступ ко всем запросам в домене https://css-tricks.com , Обратите внимание, что это работает с https но http не поддерживается. Вы также можете использовать для этого альтернативное местоположение, например https://css-tricks.com/.well-known/apple-app-site-association . Этот URL-адрес предпочтительнее, так как он может поддерживать файлы ассоциации Android, iOS и UWP в безопасной отдельной папке, которая не может быть случайно удалена.

Trivia! Универсальные ссылки не гарантируют, что приложение открыто. Если пользователь вернется на сайт из заголовка в iOS, ОС решит по умолчанию использовать веб-сайт с тех пор, пока пользователь не решит использовать это приложение, снова щелкнув заголовок с Safari.

Для шага 4 добавьте следующий код в приложение:

  func application (_ application: UIApplication, continue userActivity: NSUserActivity, restoreHandler: @escaping ([Any]?) -> Void) -> Bool {
  если userActivity.activityType == NSUserActivityTypeBrowsingWeb {
    let url = userActivity.webpageURL!
    печать (url.absoluteString)
  }
  return true
}  

  - (BOOL) приложение: (приложение UIApplication *) continueUserActivity: (NSUserActivity *) восстановление userActivityHandler: (void (^) (NSArray * _Nullable)) restoreHandler {
  if (userActivity.activityType == NSUserActivityTypeBrowsingWeb) {
    NSLog (@ "% @", userActivity.webpageURL.absoluteString);
  }
  return true;
}  

Баннеры смарт-приложений на iOS намного проще и могут быть добавлены через простой метатег-тег в разделе главы следующим образом:

Они называют тот же метод, что и пользовательские URI, которые мы рассмотрели ранее.

Windows (традиционный)

На традиционной платформе Windows (Win32 / .NET) настраиваемый URI (называемый Custom Pluggable Protocol Handler ) является единственной поддерживаемой функцией. Добавление пользовательского URI в Windows предполагает добавление записи реестра в HKEY_CLASSES_ROOT . Следующее откроет приложение с абсолютным путем, заданным при нажатии ссылки на css-трюки: // . Из-за использования командной строки это всегда открывает новый экземпляр приложения и не отправляет URL-адрес в существующее запущенное приложение.

  Редактор реестра Windows Версия 5.00

[HKEY_CLASSES_ROOTcss-tricks]
"URL-адрес протокола" = ""
@ = "CSS-трюки (имя приложения)"

[HKEY_CLASSES_ROOTcss-tricksshell]

[HKEY_CLASSES_ROOTcss-tricksshellopen]

[HKEY_CLASSES_ROOTcss-tricksshellopencommand]
@ = "" C: \ Windows \ notepad.exe ""% 1 ""  

Вышеупомянутый блокнот содержит аргумент командной строки, соответствующий указанному URL. Имейте в виду, что Notepad не поддерживает пользовательский URI и не знает, что делать с URL.

Это поведение похоже на передачу этого на консоли, и приложение должно убедиться, что оно правильно отличает аргумент как обычный CLI или пользовательский URI, как показано здесь:

  namespace ConsoleApplication1 {
  класса Программа {
    static void Main (строка [] args) {
      if (args.Length> 0 && args [0] .IndexOf ("css-tricks:") == 0) {
        Console.Write (арг [0]);
      }
    }
  }
}  

  int main (int argc, char * argv []) {
  if (argc> 1) {// argv [0] - это имя файла.
    std :: string word (argv [1]);
    if (word.compare (0, 11, "css-tricks:") == 0) {
      станд :: соиЬ << слово;
    }
  }
  return 0;
}  

Универсальная платформа Windows (UWP)

На универсальной платформе Windows вы можете использовать манифест пакета для регистрации как пользовательского URI, так и универсальной ссылки (так называемый URI-обработчик приложений ).

Пользовательский URI

Добавить объявление протокола в package.appxmanifest :

То же самое может быть достигнуто в коде:

  
  
    
       CSS-трюки 
    
  
  

... и теперь это можно обрабатывать в приложении.

  protected override void OnActivated (IActivatedEventArgs args) {
  base.OnActivated (арг);
  if (args.Kind == ActivationKind.Protocol) {
    var e = args как ProtocolActivatedEventArgs;
    System.Diagnostics.Debug.WriteLine (e.Uri.AbsoluteUri);
  }
}  

  // В приложении App.xaml.h
virtual void OnActivated (Windows :: ApplicationModel :: Activation :: IActivatedEventArgs ^ e) переопределить;

// В App.xaml.cpp
void App :: OnActivated (Windows :: ApplicationModel :: Activation :: IActivatedEventArgs ^ e) {
  if (e-> Kind == Windows :: ApplicationModel :: Activation :: ActivationKind :: Protocol) {
    auto args = (ProtocolActivatedEventArgs ^) e;
    auto url = args-> Uri-> AbsoluteUri;
  }
}  

Универсальные ссылки (URI приложения)

URI приложений поддерживаются только в браузере Microsoft Edge . Они не работают в Internet Explorer, Chrome или Firefox. У URI приложений также есть запись в виде пакетов, аналогичная пользовательскому URI. Он не доступен в пользовательском интерфейсе Visual Studio Code 2017. Записи package.appxmanifest почти одинаковы:

Если uap3 недоступен, его можно добавить в тег Package где также определен uap :

  XMLNS: uap3 = "http://schemas.microsoft.com/appx/manifest/uap/windows10/3"  

URI приложения - это относительно новая функция Windows, и многие проекты UWP нацелены на более старые версии окон в качестве минимальной версии. Возможно, вам придется столкнуться с этим, чтобы поддержать эту функцию.

Как и в iOS, веб-сайт должен подтвердить право собственности на домен, чтобы это функционировало. Это можно сделать путем размещения файла с типом mime type application / json в корне вашего сайта, например https://css-tricks.com/windows-app-web-link или https://css-tricks.com/.well-known/windows-app-web-link над https с контентом:

  {
  "packageFamilyName": "YourPackageFamilyNameHere",
  «пути»: ["*"],
  "excludePaths": ["/none/*", "https://cdn.css-tricks.com/robot.txt"]
}  

Чтобы получить имя семейства пакетов, запустите следующее в Powershell и найдите путь к вашему пакету:

  Get-AppxPackage  

Для обработки URI приложений требуется тот же код, что и пользовательские URI в Windows. По дизайну все, что вам нужно сделать, это увидеть поле протокола в предоставленном URI и написать соответствующую логику.

Как и у iOS, у пользователей Windows есть возможность отключить открытие приложений. Windows предоставляет настройки реестра, чтобы заставить приложения открываться (использовались для тестирования), а также инструмент проверки подлинности (расположенный в % windir% system32 AppHostRegistrationVerifier.exe ), чтобы проверить правильность указанных выше параметров.

Android

Пользовательский URI

Android поддерживает пользовательские URI с самого начала. Это можно сделать с помощью кода. В AndroidManifest.xml добавить:

Категория DEFAULT предназначена для того, чтобы не было никаких действий пользователя, необходимых для ее включения. BROWSABLE гарантирует, что пользовательские URI работают в браузере.

Это может быть обработано в CustomUriActivity.java при создании:

  public class CustomUriActivity расширяет AppCompatActivity {
  @Override
  protected void onCreate (Bundle savedInstanceState) {
    super.onCreate (savedInstanceState);
    setContentView (R.layout.activity_main);

    Intent intent = getIntent ();
    if (Intent.ACTION_VIEW.equals (intent.getAction ())) {
      Uri uri = intent.getData ();
    }
  }
}  

Универсальные ссылки

Универсальные ссылки в Android очень похожи на URI приложений. Android Studio предоставляет инструмент GUI для создания этого. Перейдите в Инструменты> Помощник по подключению приложений . Это обеспечит три задачи, необходимые для создания ссылок на приложения:

Для шага 1 введите редактор сопоставления URL-адресов и нажмите кнопку + чтобы открыть диалоговое окно сопоставления URL-адресов :

Как только вы нажмете OK, он покажет код, который можно было бы использовать в качестве альтернативы в AndroidManifest.xml :

Примечание: Это точно так же, как и для пользовательского URI. На шаге 2 выберите назначенное действие и добавьте код для загрузки действия. Код также точно такой же, как и для пользовательских URI выше.

На шаге 3 он будет генерировать JSON-файл, который необходимо добавить на сайт в качестве application / json mime в https://css-tricks.com/.well- известно / assetlinks.json .

  [{
  "relation": ["delegate_permission/common.handle_all_urls"],
  «target»: {
    «namespace»: «css_tricks»,
    "имя_пакета": "com.css-tricks.android",
    "sha256_cert_fingerprints":
    ["17:CC:87:9C:C8:39:B1:89:48:E8:2E:9E:6F:FC:7D:03:69:4D:05:90:2A:84:B8:AE:5D:6B:30:97:F8:1C:2B:BF"]
  }
}]  

Android Studio автоматизирует генерацию отпечатков пальцев, которая проверяет идентификатор приложения. Этот идентификатор отличается от debug и версией приложения.

Мгновенная ссылка

Мгновенные приложения на Android требуют незначительных изменений в ссылках на приложения, которые мы рассмотрели ранее. Чтобы включить мгновенные приложения, измените объявленное выше намерение так:

Это позволяет связать URL-адреса http и https с приложением, а autoVerify сообщает магазину Android (Google Play), чтобы проверить манифест автоматически. Мгновенное приложение - это функция Play Маркет / Google Chrome. Изменения в приложении минимальны для поддержки этого.

Электрон

Электронные приложения - это традиционные приложения MacOS и Windows с хроматическим временем исполнения. Эти платформы поддерживают только пользовательские URI, которые можно включить, не касаясь скомпилированного кода.

Для MacOS отредактируйте info.plist как описано в разделе MacOS. События получают объект приложения как:

  // В main.js
require («электрон»). app.on ('open-url', (event, url) => {
  console.log (URL);
});  

В Windows добавьте запись реестра, как определено в разделе Windows. Приложение получит пользовательский URL-адрес в process.argv :

  // В main.js
console.log (process.argv [2])  

В электронном режиме вы можете загружать внешние веб-страницы, которые могут открывать URL-адреса. Если желательно обрабатывать только эти URL внутри, которые могут быть зарегистрированы через электронный API:

require('electron').protocol.registerHttpProtocol('css-tricks', (req, cb) => {
  console.log(req.url)
});

Web

Going a complete circle, a website can also register custom URIs (like handling mailto: links via a website). Note that these only affect links provided in other websites and have nothing to do with links in other applications. The API is very restrictive and can be used only for a selected link type: web+. Browsers allow a pre-defined list of top level protocols to be registered:

• Chrome: mailto, mms, nntp, rtsp, webcal
• Firefox: bitcoin, geo, im, irc, iris, magnet, mailto, mms, news, sip, sms, smite, ssh, tel, urn, webcal, wti, xmpp

To register a protocol, you need to provide the same domain as the website that registers it (i.e. https://www.css-tricks.com can register only https://www.css-tricks.com and not https://css-tricks.com).

if (navigator.registerProtocolHandler) {
  navigator.registerProtocolHandler("web+csstricks", "https://css-ticks.com/?s=%s", "CSS Tricks custom URI");
}

The custom URIs are not indexed by search engines and therefore there is not much use to these apart from handling the links like mailtowebcal etc., that are already present in the web at multiple places.

Wrapping Up

Adding hyperlinks to native apps is an easy and effective way to seamlessly move the user across applications with graceful handling in case the application is not installed. With these links, applications can have provide paths all over the Internet which can be an effective promotional mechanism. Links also give websites a way to provide data and launch the applications on a specific page without the security worries that plague the downloadable files or command line scripts allowing effective tutorials and bug reports. Routing and URLs provide for the core features of the World Wide Web like navigation, the back button, bookmarks and search. Hyperlinks in apps bring these learning from the (almost) 30 years of world wide web to native applications.

Related