iOS Deep Linking - Общие проблемы и их лучшая попытка решить их

1. Основная реализация
2. проблемы
3. Постоянно добавляя более глубокие ссылки
4. Решение
5. Резюме
6. риски
7. преимущества

Кроме того, мы можем вернуть пользователей в наше приложение с мобильного сайта с помощью баннеров Smart App в браузере Safari. Ниже приведены два примера из реальной жизни. В следующих нескольких разделах мы покажем вам, что следует учитывать при реализации такой функциональности на iOS.

Основная реализация

Для поддержки глубоких ссылок в iOS лучшим подходом является использование универсальные ссылки , Универсальная ссылка - это уникальная ссылка, которая работает как для вашего (мобильного) сайта, так и для вашего приложения iOS. [1] Следовательно, чтобы использовать универсальные ссылки, мы должны обеспечить поддержку для обеих сторон. Допустим, мы хотим добавить поддержку глубокой ссылки на нашу страницу вставки рекламы, как показано ниже. Слева мы видим страницу так, как она выглядит в нашем приложении, а справа соответствующий мобильный сайт.

Мобильная ссылка - https://mobile.willhaben.at/anzeigenaufgabe, и мы определяем это как нашу универсальную ссылку. Чтобы заставить эту глубокую ссылку работать для приложения willhaben, мы сначала должны связать наши домены с приложением в Xcode.

Во-вторых, для всех связанных доменов мы должны предоставить файл JSON на стороне сервера , который может выглядеть следующим образом:

Это так называемый Яблочно-приложение-сайт-ассоциация Этот файл предоставляет Apple сведения о том, какие приложения мы хотим связать с какими путями в качестве универсальных ссылок. Важно отметить, что этот файл не может быть размещен просто где угодно. Поскольку указанные пути должны быть относительными, им нужен базовый домен, и именно здесь вы должны поместить файл ассоциации. Таблица ниже иллюстрирует это для нашего примера.

https://mobile.willhaben.at/apple-app-site-association Файл ассоциации https://mobile.willhaben.at/anzeigenaufgabe Deep Link

Когда пользователь нажимает на push-уведомление или ссылку в электронном письме, iOS отправляет ссылку в наше приложение. Чтобы знать, что с этим делать, наше приложение должно явно обрабатывать глубокую ссылку. Мы не будем вдаваться в подробности о том, как это делается сейчас, поскольку это выходит за рамки этого текста [2], но в основном приложение должно анализировать глубокую ссылку и, в зависимости от пути, решать, какую страницу открыть. Обычно глубокая ссылка предоставляет всю информацию, необходимую для открытия нужной страницы. [3]
Все идет нормально. Если мы хотим добавить поддержку более глубоких ссылок, нам просто нужно добавить их в массив путей. В следующих разделах мы увидим, почему не всегда так просто добавить поддержку для глубокой ссылки в целом, и почему это требует больше усилий, чем «просто» добавление еще одной записи в пути.

проблемы

Ссылки не-SEO

В предыдущем разделе мы упоминали, что самый простой способ добавить поддержку глубоких ссылок - это использовать универсальные ссылки. Один из лучших способов определения ваших универсальных ссылок - это использование SEO ссылки , К сожалению, на практике у вас не всегда может быть SEO-ссылка, удобная для всех типов страниц, на которые вы хотите перейти на глубокую ссылку. В целом, мы обнаружили, что чем динамичнее становится ваш веб-сайт, тем сложнее найти общий шаблон, который будет однозначно идентифицировать страницу, что является требованием для глубокой ссылки.
Чтобы обойти проблему отсутствия SEO-ссылки для каждой желаемой страницы, мы добавили «подстановочный путь», такой как / dl / *, в наш файл ассоциации.

Это позволяет нам использовать ссылки в виде https://mobile.willhaben.at/dl/my-non-seo-link-page в качестве глубоких ссылок. Хотя это кажется довольно очевидным на первый взгляд, это открывает еще одну проблему. Поскольку мы, скорее всего, хотим использовать глубокую ссылку, чтобы связать людей в наше приложение, [5] сама ссылка также должна работать [6], когда, например, она открывается в электронном письме на устройстве iOS, на котором не установлено наше приложение или даже на любом другом мобильном устройстве или компьютере, на котором невозможно запустить приложение.

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

Постоянно добавляя более глубокие ссылки

Вызов

Подумайте о следующем сценарии. Вы выпустили свое приложение с поддержкой определенной ссылки, и в следующей версии вы хотите добавить поддержку еще одной. [7] Или, вообще говоря, вы хотите добавить новую функцию.
В современной разработке программного обеспечения добавление новых функций обычно имеет отдельный рабочий процесс, и здесь, в willhaben, это не исключение. В целом, можно сказать, что каждая функция проходит от разработки (dev) до тестирования (prod). Чтобы удовлетворить эти требования, наши разработчики используют выделенную настройку среды API / приложения dev , и то же самое относится к нашей группе обеспечения качества (QA) для тестирования. Поэтому, как правило, когда мы разрабатываем функции, мы не используем «производственные URL», то есть любой непроизводственный URL имеет выделенный префикс или что-то подобное, что зависит от самой среды. См. Таблицу ниже для возможной настройки.

https://mobile-dev.willhaben.at/anzeigenaufgabe development https://mobile-uat.willhaben.at/anzeigenaufgabe пользовательский приемочный тест (QA) https://mobile.willhaben.at/anzeigenaufgabe production

Теперь мы хотим добавить поддержку для следующей ссылки на нашу страницу вставки автомобильной рекламы. https://mobile.willhaben.at/auto-verkaufen
Как упоминалось выше, каждая поддерживаемая глубокая ссылка должна быть частью массива paths - относительно сервера, на котором находится наш файл ассоциации. Теперь вы можете сразу увидеть проблему. Мы не можем определить нашу глубокую ссылку dev , поскольку наше приложение настроено так, чтобы указывать на файл ассоциации на сервере prod .

Решение

Одним из очевидных ответов было бы просто добавить файл ассоциации на наш сервер разработки и соответствующим образом настроить наше приложение, добавив соответствующий (суб) домен, см. выше , Затем мы могли бы использовать наши dev-ссылки в нашем dev-приложении, как мы обычно используем при разработке других функций. То же самое верно для QA и среды тестирования. Наконец, мы отправили новую версию приложения нашим пользователям. Есть несколько причин, по которым это может быть не самой лучшей идеей в этом случае, и мы рассмотрим ее ниже.

В целях безопасности, среди прочего, наши среды разработки и контроля качества не доступны для общественности. Однако Apple необходимо сканировать содержимое файла ассоциации на нашем сервере, чтобы связать наше приложение с нашим доменом. Поскольку сделать части этих сред общедоступными на самом деле не вариант, [8] нам нужно найти другое решение. Кроме того, и, на мой взгляд, решающий аргумент, с практической точки зрения, делает жизнь намного проще, если вы настроите свою цепочку разработки / тестирования для глубоких связей как можно ближе к производству. [9]

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

Кроме того, наше приложение должно решить, поддерживает ли оно глубокую ссылку, и, если нет, открыть системный браузер как запасной вариант. Хотя для ее решения не требуется ракетостроение, и это можно сделать так, чтобы оно зависело от окружающей среды, мы решили отказаться от него, чтобы устранить уровень сложности во всей теме глубоких / универсальных связей, поскольку он работа вообще есть достаточно сложный , Чтобы получить нашу ближайшую к работе настройку для разработки, мы используем наш обычный файл ассоциации и изменяем записи приложений, добавляя appID вместе с путями, такими как:

Теперь наше приложение для разработчиков поддерживает нашу новую глубокую ссылку https://mobile.willhaben.at/auto-verkaufen, и мы можем добавить весь код для соответствующей обработки. Мы можем отправлять электронные письма, push-уведомления и рекламу в Facebook, содержащую ссылку, и мы видим, правильно ли работает наше приложение. Особенно на этапе разработки / тестирования, когда вы обычно работаете вместе с разными людьми из разных отделов, он устраняет источник ошибки, если существует одна глубокая ссылка на страницу, а не несколько. С технической точки зрения, это позволяет нам создавать выразительные модульные тесты, которые не должны возиться с подробностями о среде.

Еще одним большим преимуществом является то, что мы действительно можем увидеть, все ли играет вместе, как и ожидалось, попробовав Smart App Banner. Обратите внимание, что он предлагает открыть наше приложение для разработчиков .

Если щелкнуть эту ссылку на баннере или ссылку в сообщении электронной почты, push-уведомления и т. Д., Мы увидим, ведет ли наша ссылка на нужную страницу в приложении. Как только мы подтвердим, что он ведет себя так, как ожидалось, все, что нам нужно сделать, это добавить ссылку на пути к нашему производственному приложению и выпустить ее.

Резюме

уверенность

Хотя универсальные / глубокие ссылки кажутся простыми в теории, многие технологии должны играть вместе, чтобы заставить их работать правильно, и это легко испортить. Мы указали, что вы должны учитывать при разработке и тестировании, чтобы ограничить сложность. Кроме того, мы постарались убрать некоторые тонкости, которые могут пойти не так во время реализации. Это позволяет нам своевременно отлавливать ошибки, а не только тогда, когда мы уже выпустили приложение.

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

риски

Внимательный читатель заметит, что представленная установка также сопряжена с некоторыми рисками и проблемами. Поскольку нам нужно изменить файл ассоциации на нашем производственном сервере, мы можем испортить что-то там.

Вот почему вы должны использовать этот подход только в том случае, если у вас есть система, в которой вы можете быстро обновить файл ассоциации, не проходя сложный сценарий выпуска сервера. [10] Другим недостатком является то, что, если ваша глубокая ссылка содержит данные, относящиеся к среде, например, данные пользователя, возможно, будет возможно получить несогласованное состояние, в зависимости от обработки этих данных.

преимущества

Преимущества установки, близкой к производственной, перевешивают эти риски, и для нас лучше "сломать" нашу поддержку глубоких ссылок, чем иметь приложение, которое ведет себя некорректно. Это особенно верно, потому что на iOS обычно требуется по крайней мере несколько дней, чтобы выпустить обновление приложения, чтобы исправить любые проблемы. С помощью представленных лучших практик, используемых в willhaben, мы пытаемся предотвратить последнее, и хотя по этой теме можно говорить гораздо больше, мы надеемся, что мы вдохновили вас, когда вы все еще пытаетесь понять, как сделай это.

Рекомендации:

1. В остальной части статьи термины глубокая ссылка и универсальная ссылка иногда используются взаимозаменяемо.
2. Отличная вводная статья может быть найдена в Apple документы ,
3. Ваша глубокая ссылка может содержать параметры запроса, например https://mobile.willhaben.at/my-deep-link?param1=x&param2=y. В лучшем случае вы можете напрямую запросить у вашего API этот URL, не манипулируя им и не создавая новый.
4. Мы используем термин динамический в смысле пользовательского контента, поэтому ваш URL-путь и параметры могут зависеть от этого.
5. Обратите внимание, что мы могли бы также использовать глубокие ссылки в приложении.
6. В смысле «постарайся доставить ожидаемый контент пользователю».
7. яблоко состояния что файл apple-app-site-association извлекается при установке приложения , однако в документации не говорится, как часто установленное приложение повторно загружает файл для обновления своих ассоциаций.
8. Мы могли бы сделать наши среды разработки доступными для Apple, разрешив определенные диапазоны IP-адресов, но вместе с нашей операционной командой мы отказались от этого, поскольку не знали бы, правильно ли мы настроили его для всех необходимых диапазонов IP-адресов. Кроме того, это, вероятно, потребует постоянной адаптации.
9. Это относится к любой функции в целом, но особенно к этой теме, поскольку разные технологии должны играть вместе.
10. Обязательно утверждать ваш JSON и ваши универсальные ссылки перед развертыванием!

Похожие

Комментарии