Инструкция по установке Xposed Framework

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

Что такое Xposed Framework и зачем нужен

До недавнего времени Xposed Framework являлся самостоятельной программой, но теперь это модуль для Магиска. Звучит немного запутанно, так что расшифруем подробнее. В первую очередь устанавливается Magisk Manager, потом для него скачивается Xposed, и уже на базе последнего ставятся модули, предназначенные именно для фреймворка. К слову, для Магиска тоже есть множество модулей, но об этом мы говорили в другой статье.

Тем временем Google принял решение выпускать новую версию операционной системы ежегодно. Разумеется, стало накладно кастомизировать прошивки: не успеваешь сделать одну, как появляется новая версия ОС. Так в 2014-ом выходит версия Lollipop и разработчики наконец обращают внимание на фреймфорк с мыслями: «Может все же стоит посмотреть что это такое? Выглядит многообещающим».

В 2015-ом году вышла очередная версия (Marshmallow) и большая часть сообщества, в итоге, признала разработку весьма стоящей, на порядок сокращающей время разработки кастомизаций стоковых прошивок в виде установки отдельных модулей, расширяющих функционал. «Ничего себе, это же совсем безопасно и есть библиотека готовых полезных модулей!» — воскликнули они.

Сейчас конец февраля 2017-го. Xposed под Nougat все еще не доступен, а толпы страждущих разработчиков и пользователей то и дело открывают темы под тип «Xposed не работает! Он мне нужен! Rovo, пожалуйста!»

Сегодня я расскажу об Xposed Framework.

Но со временем OEM-производители начали внедрять эти функции в саму оболочку своей ОС. Это, в сочетании с тем фактом, что рутирование имеет тенденцию вызывать больше предостережений, чем когда-либо прежде, привело к тому, что фреймворк ушел в небытие. Тем не менее, для технических энтузиастов, хотя это может быть дорога менее пройденная и заполненная контрольно-пропускными пунктами, но это путешествие, к которому стоит стремиться. Итак, на этой оптимистичной ноте давайте начнем с шагов по установке Xposed Framework на ваше устройство под управлением Android 13.

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

ШАГ 1. Получите root права на устройство Android 13

Прежде всего, ваше устройство должно быть рутировано через Magisk. если вы еще этого не сделали, обратитесь к нашему руководству о том, как получить root права на Android 13 с помощью Magisk Patched Boot.

Загрузите модули Riru и LSposed

Далее давайте возьмемся за два основных модуля — Riru и LSposed. Что касается последнего, мы отдали ему предпочтение перед EdXposed, поскольку он не подводит SafetyNet. Более того, он более активно поддерживается и используется, чем его аналог EdXposed.

Установите модули Riru и LSposed

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

ШАГ 5. Установите модули Xposed Framework на Android 13

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

Итак, на этом мы завершаем руководство о том, как установить Xposed Framework на свое устройство под управлением Android 13. Если у вас есть какие-либо вопросы относительно вышеупомянутых шагов, сообщите нам об этом в комментариях. Мы вернемся к вам с решением в ближайшее время.

В этом руководстве мы покажем вам шаги по установке Xposed Framework на Android 10/11/12 с помощью модуля LSPosed. Задолго до того, как модули Magisk занялись пользовательской разработкой, Xposed Framework был предпочтительным выбором для технических энтузиастов. И даже несмотря на то, что модули из бессистемного корневого приложения Magisk взяли верх, никогда не теряется любовь к вечно популярной платформе.

На данный момент я лично протестировал его на Android 10 и 11, и разработчик также заявляет о поддержке Android 12 Beta 4 (последняя на момент написания статьи). Установка Xposed теперь выполняется с использованием базового модуля Riru. В этом отношении EdXposed был первым форком, который использовал Riru и расширил поддержку Xposed. Однако, по моему личному тестированию, в процессе установки на Android 11 возникают трудности.

Даже если вы установили Riru, EdXposed просто откажется идентифицировать его и вместо этого выдаст ошибку «Ошибка установки». Именно тогда я обратил свое внимание на LSPosed, и с тех пор не было оглядки. Поэтому в этом руководстве мы покажем вам шаги по установке Xposed Framework на ваше устройство Android 10/11/12 с помощью модуля LSPosed. Следуйте вместе.

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

Рутируйте свое устройство

Прежде всего, вам нужно рутированное устройство Android с установленным Magisk. Если вы этого не сделали, вы можете обратиться к нашему руководству, чтобы сделать это:

Установите модуль Riru

Установите модуль Riru – LSPosed

Установите приложение LSPosed

Проверьте установку Xposed на Android 11/10/12

Запустите приложение LSPosed на своем устройстве, и оно должно отображать статус «Активировано». Теперь вы можете приступить к установке модулей.

Как установить модули Xposed Framework на Android 10/11/12

Как исправить Bootloop/Soft-Brick после установки Xposed

Вот и все. Это были шаги по установке Xposed Framework на Android 10/11/12 с использованием LSPosed. Хотя его репозиторий модулей еще не соответствует уровню EdXposed, но он работал без каких-либо проблем, а также был немного лучше с точки зрения производительности. Каковы ваши взгляды на то же самое? Дайте нам знать в разделе комментариев ниже.

Навигация по записям

Основной код, если вы конечно не решили всего лишь изменить цвета или шрифты какого-то приложения, происходят в handleLoadPackage. Для этого мы предварительно изучаем исходный код интересующего приложения, придумываем как модифицировать код и описываем нашу логику.
Основная логика работает через findAndHookMethod метод, реже через findAndHookConstructor и findClass. Все основные методы можно подглядеть в классе XposedHelpers.

Выглядит это примерно так:

В первую очередь нам надо обернуть наши «хуки» в try/catch, так как если в вашем коде будет ошибка, без обертки основное приложение может завершить работу c ошибкой, а полный трейс может попасть разработчику, который станет в курсе, что на его приложение наложили модуль. При обертке весь трейс можно вывести в лог Xposed и понять где у нас произошла ошибка и почему.

В findAndHookMethod первый параметр — это название класса, вторая — ссылка на загрузчик класса, третья — название нужного нам метода, далее идет перечисление в виде строк какие переменные передаются в метод и в конце наш callback метод.

Вот пример как можно заполучить контекст класса и воспользоваться им

Мы отлавливаем загрузку метода init в классе DriverApplication и через param.thisObject используем контекст для отправки широковещательного сообщения нашему ресиверу или сервису.

или если необходимо изменить передаваемые переменные в метод, то сделать это можно через

Помимо XC_MethodHook можно использовать XC_MethodReplacement. Название говорит само за себя. Мы полностью заменяем какой-то метод нашим собственным. Вот типичный пример когда мне захотелось избавиться от всплывающего уведомления, когда я подключаю телефон по USB к ноутбуку

В данном void методе вызывалось уведомление. Я его просто заменил и забыл что мне когда-то это мешало.

Были случаи и посложней. Я своими модулями исправлял ошибки в системных приложениях. Ждать, когда производитель исправит баг в новом ОТА приложении меня не особо прельщало, поэтому я исправлял сам.

Вот так вот я разрешал всем приложениям писать информацию на SD карточку, когда этот функционал урезали в целях безопасности на KitKat.

Доступ к переменным и методам класса осуществляется через класс XposedHelpers. Например:

Object mActivity = XposedHelpers.getObjectField(param.thisObject, «mActivity»);

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

(Activity) mActivity = (Activity) XposedHelpers.getObjectField(param.thisObject, «mActivity»);

и облегчить дальнейший код. Если же объект является каким-то типом внутреннего класса, который нам не доступен для импорта, в дальнейшем использование его методов и свойств также доступно через XposedHelpers.

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

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

Что касается обфусцированных приложений, на первый взгляд нужно переписывать модуль при каждом новом релизе приложения. Выход из этого положения всегда есть, но это отдельная тема. Основной принцип — это найти класс, который не обфусцируется и бэктрейсом определить имена классов и методов.

Отступление

Больше трех лет назад я начал писать цикл статей про модификацию прошивок для Android. В данный момент актуальность данных статей весьма сомнительна: процесс очень трудоемок, требует много времени и инструментов, а малейшая ошибка может обернуться значительными проблемами вплоть до полной перепрошивки телефона.

Я прождал около двух лет в надежде, что кто-то все же опишет на Хабре что такое Xposed Framework и как он может упросить процесс кастомизации приложений, но подозреваю, что мало кто знаком с этим чудным творением. Для своих нужд я написал несколько десятков модулей, некоторые даже публиковал в общем репозитарии, который на данный момент содержит более 1000 готовых к эксплуатации разработок. Каждый модуль — это может быть не одна единственная кастомизация, а целый набор функций с интерфейсом настроек или дополнительного функционала. Яркий пример тому GravityBox или Sense ToolBox.

Я не буду описывать процесс установки и получение root прав, а хочу описать что из себя представляет фреймфорк и как написать простейший модуль.

Какие модули выбрать и как установить

Есть три метода установки модулей для EdXposed. Первый вариант самый простой: открываем программу и в строку поиска вводим название нужного патча, или просто просматриваем вкладку «Модули» и загружаем подходящие. Принцип такой же, как в Magisk. После установки перезагружаем девайс.

Второй вариант немного сложнее: ищем необходимые модули на просторах интернета, скачиваем их в формате apk и устанавливаем, как обычное приложение. И третий метод (самый сложный): после загрузки патча с расширением apk заходим в кастомное рекавери и прошиваем файл, нажав по кнопке «Install». Во всех случаях обязательно перезагружаем смартфон, как только модуль установится.

Теперь рассмотрим наиболее популярные патчи, которые можно поставить через EdXposed:

Найти множество полезных модулей можно как на официальном сайте , так и на

Что нужно для работы Xposed Framework

Итак, сам по себе Xposed бесполезен. Он нужен именно в качестве платформы для установки модулей, которые самостоятельно не функционируют. В свою очередь, для работы Xposed обязателен Magisk. И поверх этого располагается главное требование — наличие root-прав. Без них не будет работать ни фреймворк, ни Магиск.

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

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

Установка

Если раньше для установки сторонней прошивки требовалось производить разблокировку загрузчика телефона, то для использования Xposed пользователю необходимо всего лишь иметь root права на телефоне. Даже сейчас получение этих прав на большинстве девайсов не представляет больших сложностей: вы скачиваете приложение, а оно само делает все нужные манипуляции и через несколько минут вы становитесь обладателем телефона с уровнем прав «БОГ».

Принцип работы «на пальцах»

В системе Android есть процесс под название «Zygote». Это и есть основная исполнительная система. Любой процесс запускается как его копия. Zygote запускается через /init.rc как только загружается основное ядро системы. Запуск приложений осуществляется через скрипт /system/bin/app_process, который подгружает необходимые классы и запускает инициализацию приложения через задекларированные методы.

Именно в этом месте на сцену выходит Xposed. При установке фреймворка модифицированный app_process копируется в /system/bin. Суть модификации в том, что в переменную среду добавляется дополнительная jar библиотека, которая может исполнять специальные методы при определенных условиях и случаях. Например, мы можем вмешаться сразу, как только создается виртуальная машина Dalvik или даже перед тем как будет вызван основной метод Zygote. Являясь частью процесса Zygote, мы можем вмешиваться в работу любых методов, даже синтетических и производить любые действия в их контексте.

Практическая ценность Xposed

Предположим, необходимо изменить какой-то метод, и, например, вместо булева значения TRUE вернуть FALSE. Вместо трудоемкого и затратного традиционного метода (разбираем-собираем-тестируем приложение) вы можете «перехватить» этот метод класса и «вживить» свой Java код, который произведет необходимую операцию (изменит, в данном примере, значение) и вернет нужный нам результат. При этом, с Xposed можно: модифицировать или просто посмотреть какие данные передаются в метод, либо после исполнения метода узнать результат обработки данных и в зависимости от требований изменить их или воспользоваться ими.

Бывают случаи, когда вы не хотите, чтобы тот или иной метод вообще срабатывал, либо хотите полностью поменять логику и алгоритм. Xposed позволяет полностью заменить метод, либо не дать ему вообще сработать.

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

А теперь главное — зачастую не приходится даже изменять работу модуля (или производить минимальные доработки) с выходом новой версии прошивки/приложения! Это логично, ведь названия методов, классов и переменных, как правило, остаются прежними.

Не правда ли, удобно?

Скачивание и установка фреймворка на Xiaomi

Об установке Магиска мы писали в отдельной статье, там представлена подробная инструкция. Поэтому сразу приступим к самому фреймворку. Все нижеописанные процедуры вы проводите на свой страх и риск! Установка программы или какого-то модуля может привести к серьезным проблемам со смартфоном, вплоть до состояния «кирпича».

Если ваш смартфон работает под управлением 9 или 10 ( 11/MIUI 12), нужно установить программу под названием . Стандартная утилита не подходит для вышеуказанных версий программного обеспечения. Также должна нормально функционировать на 12.5 под управлением 11, но точно гарантировать работоспособность мы не можем.

Приступаем к операции:

и зайдите во вкладку «Репозиторий».

2.В поисковую строку вбейте название модуля «)». Данный патч понадобится, если смартфон перестанет запускаться после установки фреймворка. Кликнете по стрелке возле названия модуля и выберите «Установить». Далее тапните по желтой кнопке для перезагрузки.

4.Перезагрузите мобильное устройство.

6.Опять перезагрузите смартфон.

7.Откройте установленный фреймворк. Если на стартовой странице есть надпись « активирован», значит, вы все сделали правильно.

На этом установка фреймворка завершается. Но не забываем, что это только «каркас» для модулей. Самое интересное — выбор и загрузка патчей, впереди.

Что делать, если фреймворк не устанавливается

Бывает, что программа выдает оповещение « установлен, но не активирован». Это значит, что на телефоне отсутствует один из двух необходимых патчей: «» или «». Обязательно проверьте наличие этих модулей в Магиске. Если установка через репозиторий оказывается недейственной, воспользуйтесь . Еще не забудьте перезагрузить смартфон.

Создание модуля

Сам модуль — это обычный apk файл, созданный в среде разработки. В нем не обязательно должно присутствовать какое-то Activity либо графические ресурсы. По сути там может быть только один файл с инструкцией, разумеется помимо обязательных файлов, и модуль может работать. Для настройки нам надо сделать три вещи:

Manifest. xml

При установке любого приложения Xposed проверяет наличие определенных заголовков в Manifest.xml. Если есть три нужные строки, то фреймворк сохраняет информацию о приложении в своих настройках и далее вы можете активировать установленный модуль (здесь и далее будут использоваться примеры кода разных модулей, в том числе и для из известных приложений).

С первой строкой все понятно.

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

Третья строка определяет как будет идентифицироваться ваше приложение в списке доступных или установленных модулей на вашем телефоне.

/assets/xposed_init

В корне вашего приложения необходимо создать папку assets и положить в него файл с названием xposed_init. Внутри этого файла вы просто пишите в каком Java классе описана работа вашего модуля. Я привык называть класс как XMain. В моем случае в файле присутствует строка

Java class

Сам класс должен содержать один из трех методов для работы с фреймворком. Не обязательно указывать все, можно лишь указать те, с которыми вы планируете делать модификацию приложения или приложений. Я по привычке указываю все как шаблон.

Метод initZygote исполняется тогда, когда

Метод handleLoadPackage исполняется в тот момент, когда Dalvik загружает исходный код

! приложения при запуске. Это очень важный момент. Если у вас в телефоне 10 различных модулей, то через этот метод исходники запускаемого приложения «прогонятся» во всех 10-ти случаях. Для фильтрации используется обычная проверка по названию пакета. Разумеется, если вы хотите изменить работу нескольких приложений, то ставите столько проверок сколько вам нужно.

Метод handleInitPackageResources нужен вам тогда, когда вы хотите подменить ресурсы приложения во время их загрузки в память. Здесь тоже самое как и с handleLoadPackage — вы фильтруете по названию приложения.

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

Полное удаление программы

Первым делом удалите из Магиска патчи «Riru — core» и «Riru — EdXposed». Для этого откройте раздел «Модули» и кликнете по изображению корзины возле модулей. От приложения EdXposed Manager избавьтесь стандартным способом, зажав на несколько секунд ярлык на рабочем столе и кликнув «Удалить».

Мы разобрались со скачиванием и установкой фреймворка Xposed. Процедура довольно сложная, поэтому советуем приступать к ней только опытным пользователям. Если утилита не понравится, ее в любой момент можно удалить.

Заключение

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

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