1. Общая информация о программе.
Краткое описание
Программа, облегчающая труд при редактировании и сборке тем и патчей для прошивок MIUI.
Описание возможностей программы
- Создание патчей TWRP, модулей Magisk и тем из готового набора модификаций
- Создание патчей TWRP, модулей Magisk и тем с логотипами операторов сотовой связи.
- Объединение нескольких патчей TWRP, модулей Magisk или тем в один патч TWRP, модуль Magisk или тему.
- Встраивание в темы MIUI заранее подготовленных патчей TWRP, модулей Magisk, в том числе патча с логотипами операторов сотовой связи.
- Слияние оформления в темах.
- Автоматическая распаковка для редактирования и обратная упаковка тем.
- Проверка кода в .xml файлах в теме.
- Проверка на наличие повторяющихся строк кода в .xml файлах в теме.
- Проверка на наличие лишних файлов в теме.
- Сохранение результатов проверки в текстовый файл.
- Распаковка, редактирование и упаковка файлов 9.png.
- Визуализированное редактирование цвета в файлах theme_values.xml.
- Сохранение всех настроек программы в Проект, создание новых проектов и удаление старых.
2. Установка программы
3. Инструкции
3.1. Работа с проектами
3.2. Изготовление патча TWRP, модуля Magisk или темы из каталог патчей
Запустить MIUIThemesMod.exe.
На вкладке «Каталог патчей» в поле «Версия MIUI» выбрать, для какой версии MIUI собрать модификацию.
Примечание: Пока в программе представлены патчи только для MIUI 10.
В поле «Выбранный патч» выбрать необходимую модификацию из списка.
Различные варианты модификации выбираются в поле «Вариант патча». Если модификация есть только в одном варианте, то список не раскрывается.
Если патч вносит изменения в языковую часть прошивки, то выбор локализации производится в поле «Язык».
Примечание: Пока в программе нет таких патчей, поэтому это поле можно не трогать.
Поле «Файл собираемого патча» предназначено для выбора места сохранения готовой модификации и присвоения ей имени. Выбор осуществляется нажатием на значок папки внутри поля. Значок папки снаружи поля предназначен для перехода в папку с собранной модификацией.
Примечание: По умолчанию готовый файл *.zip или *.mtz сохраняются в папке с программой.
Справа от полей настроек, есть изображение для визуальной оценки вносимых изменений. Клик левой кнопкой мыши по картинке или рядом с ней откроет окно предварительного просмотра. Если изображений несколько, то по ним можно перемещаться с помощью стрелок внизу окна просмотра. В случае одного изображения, эти стрелки не активны.
Кнопки «Собрать тему», «Собрать патч TWRP» и «Собрать модуль Magisk» предназначены для изготовления соответствующих типов файлов.
В случае, если вы используете кнопку «Собрать тему», по окончании сборки появляется окно «Свойства темы». Оно служит для создания файла описания темы description.xml. В нем производится выбор для какой версии MIUI производится сборка темы или же выбирается пункт «Не использовать» и тогда файл description.xml будет отсутствовать в собранной теме. При отсутствии этого файла тему нельзя будет установить через приложение «Темы».
В случае, если вы используете кнопку «Собрать модуль Magisk», по окончании сборки появляется окно «Свойства модуля Magisk». Поле «Идентификатор» обязательно заполнять английскими буквами без пробелов и знаков препинания. Остальные поля заполняйте на свое усмотрение.
Кнопка «Добавить в слияние файлов» предназначена для добавления предварительно собранного патча или темы на вкладку «Слияние файлов».
Примечание: Если итоговым файлом в процессе слияния планируется сделать *.zip для установки из TWRP, то собирать для последующего объединения следует патчи, а не темы. Программа не позволит выполнить слияние *.mtz + *.mtz или *.mtz + *.zip в файл *.zip. Из такого набора можно собирать только тему в формате mtz.
3.3. Изготовление патча TWRP, модуля Magisk или темы с логотипами операторов сотовой связи
На вкладке программы «Логотипы SIM» в поле «Версия MIUI» выбрать, для какой версии MIUI собрать патч.
В поле «Язык» выбрать язык локализации прошивки.
В полях «Страна SIM-карты 1» и «Страна SIM-карты 2» выбрать страну расположения оператора сотовой связи предоставляющего услугу
В поле «Логотип SIM-карты 1» и «Логотип SIM-карты 2» выбрать своих операторов связи.
В поле «Наименование SIM-карты 1» и «Наименование SIM-карты 2» ввести наименование компании оператора сотовой связи, либо выбрать из выпадающего списка понравившийся вариант текста. (этот текст будет отображаться вместо надписей «SIM 1» и «SIM 2»)
В поле «Файл собираемого патча» нажать на значок папки внутри поля и выбрать куда сохранить патч и ввести его название.
Примечание: По умолчанию готовый файл *.zip или *.mtz сохраняются в папке с программой.
Нажать на кнопку «Собрать тему», «Собрать патч TWRP» или «Собрать модуль Magisk» для изготовления соответствующих типов файлов, дождаться завершения выполнения операции.
В случае, если вы используете кнопку «Собрать тему», по окончании сборки появляется окно «Свойства темы». Оно служит для создания файла описания темы description.xml. В нем производится выбор для какой версии MIUI производится сборка темы или же выбирается пункт «Не использовать» и тогда файл description.xml будет отсутствовать в собранной теме. При отсутствии этого файла тему нельзя будет установить через приложение «Темы».
В случае, если вы используете кнопку «Собрать модуль Magisk», по окончании сборки появляется окно «Свойства модуля Magisk». Поле «Идентификатор» обязательно заполнять английскими буквами без пробелов и знаков препинания. Остальные поля заполняйте на свое усмотрение.
Кнопка «Добавить в слияние файлов» предназначена для добавления предварительно собранного патча или темы на вкладку «Слияние файлов».
Перейти в папку с собранным патчем или темой (нажать на значок папки справа от поля «Файл собираемого патча»), перенести на телефон и установить через TWRP или через приложение «Темы».
Примечание: Готовый патч можно использовать для установки через TWRP, для патчинга тем и для объединения патчей и тем. Готовую тему можно использовать для установки через приложение «Темы», для патчинга тем и для объединения патчей и тем.
3.4. Создание объединенного патча TWRP, модуля Magisk или темы
Запустить MIUIThemesMod.exe.
На вкладке программы «Слияние патчей» нажать кнопку «Добавить файл» и указать путь к файлу. Повторить действие для добавления файлов.
Стрелками «вверх» и «вниз» отрегулировать очередность слияния или кнопкой «удалить» удалить неверно указанный файл.
Примечание: следует иметь ввиду, что если в патчах будут встречаться одинаковые строки или изображения, то сохраняться будет информация из нижележащего в списке файла патча.
В поле «Файл результирующего патча» указать желаемое расположение и имя для файла (нажать на значок папки внутри поля и выбрать куда сохранить патч и ввести его название).
Нажать на кнопку «Собрать тему», «Собрать патч TWRP» или «Собрать модуль Magisk», дождаться завершения выполнения операции.
Примечание: Программа не позволит выполнить слияние *.mtz + *.mtz или *.mtz + *.zip в файл для установки из TWRP. Из такого набора можно собирать только тему в формате mtz.
Перейти в папку с собранным файлом патча или темы (нажать на значок папки справа от поля «Файл собираемого патча»), перенести его на телефон и установить через TWRP или через приложение «Темы».
Примечание: Готовый патч можно использовать как для установки через TWRP, так и для патчинга тем. Готовую тему можно использовать как для установки через приложение «Темы», так и для патчинга тем.
3.5. Встраивание в тему патчей TWRP (в т.ч. патча с логотипами операторов сотовой связи) или модулей Magisk
Создать с помощью программы патч по инструкциям выше. (не обязательно)
Запустить MIUIThemesMod.exe
Перейти на вкладку «Патчинг темы»
В поле «Файл исходной темы» указывать файл с темой, на которую будут накладываться изменения.
В поле «файл накладываемой темы или патча» указать файл с патчем или темой изготовленными по инструкции п.п. 3.2., 3.3. или любой другой созданный по этому же принципу.
В поле «Файл результирующей темы» будет автоматически предложен вариант названия и расположения созданной темы или же можно нажать на значок папки внутри поля и выбрать другое место расположения сохраняемой темы.
Нажать кнопку «Собрать тему», дождаться завершения выполнения операции.
Примечание: Если программа во время сборки выдает ошибку «Невозможно объединить файлы... xml», проверьте указанный файл на предмет кодировки. Кодировка во всех xml должна быть UTF-8 без ВОМ. В противном случае тема будет собрана с исходным файлом theme_values.xml без объединения.
По окончании сборки будет предложено создать новый файл description.xml через меню в окне «Свойства темы».
Тема готова. Для перехода в папку с собранной темой, нажать на значок папки справа от поля «Файл результирующей темы». Можно перенести ее на смартфон и импортировать через приложение «Темы».
Примечание: Аналогичным образом можно слить две темы в одну. При этом нужно учитывать, что программа возьмет за основу исходную тему и добавит/заменит в ней все оформление из второй темы. Имея некоторые понятия об устройстве тем, можно предварительно исключить из второй темы лишнее и наложить на исходную тему лишь то, что желаете к ней добавить или изменить. Для удобства работы с темами предусмотрена возможность автоматической распаковки и упаковки темы.
3.6. Распаковка и упаковка тем
Запустить программу MIUIThemesMod.exe.
Перейти на вкладку «Распаковка и упаковка».
Выбрать файл темы (нажать на значок папки внутри поля «Файл распаковываемой темы» и выбрать тему).
Указать каталог для распаковки (нажать на значок папки внутри поля «Каталог распакованной темы» и выбрать каталог).
В поле «Режим обработки файлов 9.png» выбрать из предлагаемых вариантов необходимый вам способ обработки графических файлов с разметкой.
Внимание! Не все файлы 9.png содержащиеся в теме имеют разметку, соответственно они не могут быть корректно обработаны программой. Используйте пункты «Декомпилировать с…» будучи только в полной уверенности в обязательном наличии разметки во всех файлах 9.png распаковываемой темы.
Нажать кнопку «Распаковать тему», дождаться завершения выполнения операции.
Перейти в папку распакованной темы (нажать на значок папки справа от поля «Каталог распакованной темы») и внести необходимые изменения.
Внимание! Утилита не проверяет корректность файлов, измененных Вами. Если не умеете, например, работать с 9.png - лучше не меняйте файлы самостоятельно.
Нажать кнопку «Упаковать тему», дождаться завершения выполнения операции.
Всё, тема или патч для другой темы готов.
Для перехода в папку готовой темы необходимо нажать на значок папки справа от поля «Файл запаковываемой темы».
Примечание: Флажок «Проверять тему при запаковке» предназначен для проверки правильности кода в .xml, допустимых типов файлов и наличие повторяющихся строк кода в .xml во время запаковки.
Кнопка «Проверить тему» служит для проверки кода в .xml, допустимых типов файлов и наличие повторяющихся строк кода в .xml в распакованной теме.
Кнопка «Задать свойства» служит для написания файла description.xml через интерфейс программы.
Поле «Допустимые в теме файлы» предназначено для указания расширений файлов, которые должны остаться в теме, остальные будут показаны в окне ошибок как неверные. При нажатии на красный крест возле поля, произойдет его автозаполнение используемыми в темах типами файлов. Содержимое поля можно редактировать самостоятельно. Если окно оставить незаполненным, проверка по типам файлов проводиться не будет.
Флажок «Запаковывать только допустимые» непосредственно связан с настройкой «Допустимые в теме файлы». Файлы, расширения которых не указаны в поле «Допустимые в теме файлы» не будут добавляться в запаковываемую тему.
3.7. Работа с изображениями 9.png
Для работы с 9.png файлами необходимо наличие нужных файлов в папке Tools и установленная обновленная версия Java.
Запустить программу MIUIThemesMod.exe.
Перейти на вкладку «Работа с 9.png» и подвкладку «Декомпиляция».
Указать расположение исходного файла изображения или нескольких изображений 9.png для распаковки (нажать на значок папки внутри поля «Каталог исходных файлов 9.png» и выбрать каталог).
Указать каталог для декомпиляции файла или файлов (нажать на значок папки внутри поля «Каталог для декомпиляции файлов» и выбрать каталог или оставить сгенерированное программой расположение каталога без изменений).
Нажать кнопку «Декомпилировать файлы», дождаться завершения выполнения операции.
Перейти на подвкладку «Редактирование и компиляция», нажать на кнопку «Редактор» и произвести необходимые изменения в разметке.
Указать каталог для компиляции файла (нажать на значок папки внутри поля «Каталог для компиляции файлов» и выбрать каталог).
Нажать кнопку «Скомпилировать файлы».
Для перехода в папку со скомпилированными файлами, необходимо нажать на значок папки справа от поля «Каталог для компиляции файлов».
3.8. Принцип работы программы при патчинге темы
В распакованном патче сразу удаляет meta-inf и busybox (эти файлы нужны для патчей, устанавливаемых через рекавери).
Ищет все остальные файлы и последовательно обрабатывает каждый.
При обработке файла в первую очередь программа ищет файл с тем же именем в теме что и в патче.
Если не находит - просто копирует его из патча в тему.
Если находит, то распаковывает файл патча и одноименный файл темы.
Последовательно перебирает распакованные файлы второй стадии распаковки патча и сравнивает их с файлами в теме.
Если в теме нет файла с тем же именем и по тому же пути, то просто копирует его в тему.
Если файл в теме есть, то проверяет расширение файла.
Если расширение не xml, то просто заменяет файл.
Если xml, то обрабатывает по xml-тегам. Если в файле темы есть такой же тег, с тем же значением атрибута name, то текст тега заменяется. Если тег не найден, то добавляется.
Файл темы запаковывается обратно.
Когда все файлы обработаны - измененная тема запаковывается по указанному пути.
3.9. Палитра цветов
Перейти на вкладку «Палитра цветов».
В поле «Файл XML для обработки» выбрать файл theme_values.xml из распакованной темы. После этого в нижележащем поле отобразятся все настройки цветов и их прозрачность из выбранного файла.
Клик левой кнопкой мыши в ячейке с отображаемым цветом и прозрачностью вызовет дополнительное диалоговое окно «Подбор цвета MIUI».
Клик левой кнопкой мыши в поле «Фоновое изображение» вызывает диалоговое окно выбора файла подложки (файл изображения рабочего стола).
Клик левой кнопкой мыши в поле «Выбранный цвет» вызывает диалоговое окно «Цвет» для выбора требующегося цвета.
Примечание: Пипетка в диалоговом окне «Цвет» действует в пределах всего экрана монитора.
Для сохранения настройки цвета и прозрачности нажать кнопку «Выбрать» или нажать кнопку «Отменить» для отказа от внесения изменений.
Примечание: Если изменения цвета были внесены ошибочно, нажать кнопку «Перечитать файл» во вкладке «Палитра цветов».
Для сохранения внесенных изменений в файл theme_values.xml нажать кнопку «Записать в файл» во вкладке «Палитра цветов».
Комментариев нет:
Отправить комментарий