编辑器安装



1、下载编辑器

  • 点击这里下载编辑器
  • 解压后 Windows 下执行根目录下的 MIUINewThemeEditor.exe 即可打开编辑器,mac 下执行编辑器子目录(类似 19.5.31_1559298827 的文件夹,不同版本文件夹名称不一样)MIUINewThemeEditor.jar 文件打开编辑器
  • mac 系统需提前安装 java 环境。

2、编辑器更新

  • 编辑器器有更新时,打开编辑器会自动收到更新
  • 如果更新过程中提示解压失败,请进入编辑器二级目录(类似 19.5.31_1559298827 的文件夹,不同版本文件夹名称不一样)下找到一个 zip 包,把这个 zip 包拷贝出来手动解压一次即可

3、注意事项:

  • 编辑器在连接手机时需要开启 USB 调试,开启 USB 调试方法:
    • 开启 USB 调试需要先开启开发者选项,开启开发者选项方法:设置-我的设备-全部参数,连续点击 MIUI 版本(至少 7 次,直到提示:您已处于开发者模式,无需进行此操作)
    • 开启手机 USB 调试方法:设置-更多设置-开发者选项,开启 USB 调试,第一次连接到电脑时,手机会弹出允许 USB 调试的弹窗,选择允许后电脑与手机的 usb 调试就建立好了,后续无需再次开启(注意,再手机的安全中心进行手机优化后,系统可能会把 USB 调试模式关闭,如果关闭了,请按照上面的步骤重新开启 USB 调试)。
  • 编辑器无法应用主题、打不开可能的原因

    • 连接手机后,若是第一次打开编辑器或新建主题,需要等待一点时间,并非卡机
    • 添加了插件后,应用失败
      • 编辑器 plugin 目录下是否包含你添加的插件,若 plugin 目录不包含添加过的插件会合成失败,可以通过检查主题包内 plugin_config.xml 文件来查看添加过的插件。
      • 手写的 manifest 文件有语法错误。某行代码内添加了两个相同的属性,比如一行代码内写了两个 X 坐标。或者属性之间原本需要空格分开的缺少空格,都会导致插件应用失败。
    • 其他情况排查步骤如下:
      • 检查手机是否打开了 USB 调试,检查步骤:系统设置–全部设置–开发者选项–usb 调试(开),
      • 打开任务管理器查看是否有多个 adb 进程,建议卸载或关闭其他占用 adb 的进程,或在主题编辑器菜单里点击“修复 adb”(仅 win 下可用)
      • 驱动程序未安装,下载手机驱动程序,可点击这里 下载 miflash 来安装驱动。安装方法:打开 miflash,点击左上角的 Driver 按钮即可自动安装,安装完驱动后如果你不需要了可以直接删除 miflash
      • 更换 USB 线缆或接口
  • MAC 下使用

    • 先安装 MAC 版 java 环境。
    • 由于 mac 安全设置,第一次直接执行 MIUINewThemeEditor.jar 可能不被系统允许,你可以右键选择打开,在弹出的窗口中选择打开编辑器,后续即可双击直接打开了。
  • 编辑器目录结构不可有空格等特殊字符,最好不要放在中文目录下


创建主题包



新建主题
点击“新建”按钮,会弹出一个主题信息的弹窗(如图),填完所有信息点击确定即可开始正式的制作主题之旅啦~

image

image




编辑器使用

新建主题之后,编辑器进入编辑界面,如图,顶部为菜单栏,右侧侧边栏可选择编辑的模块

image

注意:

  • 菜单栏的刷新按钮,一般用于修改了内置插件时重建缓存用,否则修改了内置插件不会生效,插件的制作教程详见
  • 【专家模式/效率模式】 按钮可切换编辑器编辑模式,在效率模式可以一键在主题中插入一套深色模板,少量修改即可覆盖短信、联系人、设置等界面。专家模式则需要所有的资源自己一个个去手动修改。相比较而言,效率模式更高效,专家模式可定制一些特殊的效果,平时一般推荐在效率模式完成一套主题即可。
  • 菜单简介
    点击左上角菜单,弹出一个列表。重点需要了解几个功能,前提是编辑器能正常把主题应用到手机上:
    • 导出主题包:这个是上传至主题商店的唯一文件格式(.mtz),所有主题完成之后都需要导出主题包。
    • 同步图标/模块:线下编辑器的素材有限,如果在编辑器中找不到手机上显示的图标或者素材,可以直接同步图标/素材,然后去相应的模块找即可。
    • 编辑信息:主要是更改主题版本,当 UI 版本为 V8 的时候,编辑器展示 MIUI8/9 的界面和素材,当 UI 版本为 V10 的时候,编辑器会展示 MIUI10 系统的界面和素材。


1、创建第一个锁屏

image

插入一个解锁功能

  • 点击第编辑器左侧侧边栏的锁型图标,在插件选择区选择锁屏框架,然后添加一个上划解锁框架,点击插入按钮
  • 点击编辑器左下角手机形状按钮,即可应用主题到手机。
  • 解锁一次,然后息屏再开屏,重新回到锁屏。你会发现手机底部有两个小图标。这时候解锁插件应用就成功了。

操作完上面的步骤以后,我们发现锁屏其他部分全是黑的,没关系,因为这个时候你只是添加了一个解锁控件,其他控件都还没加呢。
添加其他插件

  • 添加一张壁纸和一个时钟控件,分别选择【主题壁纸-百变锁屏壁纸-下划切换壁纸】 和 【百变锁屏-锁屏时钟-横向图片时钟】插入
  • 应用主题后锁屏界面就出现了一张壁纸和一个时钟。
  • 我们可以用同样的方法给锁屏添加一个负一屏控件或则其他控件,就跟搭积木一样,一个锁屏就构建出来了。

上面操作完成后我们发现之前添加的解锁框架底部的两个小图标不见了,原因是你新添加的壁纸把他给盖住了,如上图所示,我们需要对插件的图层进行调整
插件的图层管理

  • 在编辑器右侧的图层管理区,先选择要调整孙旭的插件,然后点击底部上上下箭头按钮,即可调整插件的顺序
  • 我们尝试把下滑切换壁纸调整到最顶上,重新应用主题壁纸就不对锁屏其他元素进行遮挡了。
  • 在编辑器中图层越往上的插件,在锁屏实际显示中则越往下,要想不被其他插件盖住,则在编辑器中把插件调整到另一个插件的下面即可

我们还可以对添加的进行个性化定制,替换其中的图片资源,修改模块的各项参数,使插件的样式更符合我们的设计需求
插件的个性化定制

  • 进入参数编辑器,参数编辑区可选图片资源编辑和参数编辑,我们可以替换插件里的图片资源,也可以修改插件的参数,例如调整插件的坐标、色彩等
  • 需要注意的是是图片序列的图片资源,因为修改的不是单独一张图片,而是多张图片组成的图片序列。替换时需要把需要替换的图片以’xx_0.jpg’ ‘xx_1.jpg’ ‘xx_2.jpg’ 这样的规则命名(后面的数字及格式与原资源素材相同),然后拉进编辑器如图红色框选区域即可替换对应资源,非图片序列的图片替换时无需特殊命名,只需要格式一致即可。

插件中常用参数的修改可参考下表

常用参数名 对应参数 释义
横向对齐(或 X 方向对齐) left、 center、right 居左 居中,居右
纵向对齐(或 Y 方向对齐) top、 center、bottom 顶部 居中,底部
可见性 0 或 1 0 不可见,1 可见,可用表达式
透明度 0~255 0 为透明度为 0,255 为透明度 100%,可用表达式
颜色 #ffffff 可从 ps 里吸取对应的颜色值


2、其他界面模块的修改

image

  • 添加界面模块
    • 点击右侧侧边栏的星星按钮,即可进入编辑器界面编辑功能(星星按钮只在效率模式有,专家模式会把各模块独立展现)
    • 选择深色模板或浅色模板(浅色模板开发中,暂不可用),人后通过右侧的参数编辑器就可以对界面的图片和颜色进行修改了
    • 切换到专家模式后,各界面在侧边栏分为独立按钮,点击不同按钮进入到对应界面进行修改

注:效率模式为编辑器中制作界面的全新方式,效率模式内置了一套完整的深色主题模板,模板内已经内置了制作一套深色主题所需要的所有资源,相关颜色值也已打包进模板中,通过模板外漏的相关接口,只需少量修改即可完成界面部分的制作,大大提高制作一套主题的效率。




  • 专家模式中常用界面颜色值标注

    • 可以快速查看界面相关区域颜色值(持续维护更新 ing)
  • V9 适配 V10 主题教程

  • 点九图的定义与绘画
    image
    上图报错是因点九图绘画不规范导致,点九图是 Android 开发中用到的一种特殊格式的图片,文件名以”.9.png“结尾,这种图片能告诉程序,图像哪一部分可以被拉升,哪一部分不能被拉升需要保持原有比列。
    通过指定.9 拉伸与显示区域即可实现在素材拉伸后不会降低显示效果;例如一个圆角矩形直接放大会变模糊、通过绘制.9 后就能保证只拉伸圆角内的区域,从而达到最佳的显示效果,
    具体看详解


主题包结构

  • clock_2x4 桌面时钟
  • com.miui.home 桌面
  • com.android.contacts 拨号与联系人
  • com.android.mms 短信
  • com.android.settings 设置
  • com.android.systemui 通知栏
  • framework-miui-res MIUI 全局
  • framework-res 安卓原生全局
  • icons 桌面图标
  • lockscreen 锁屏
  • miwallpaper 百变壁纸
  • wallpaper 壁纸
  • description.xml 主题描述文件
  • 以上是目前常用的主题包目录结构,包括但不限于这些,随着主题的深化及需求的增加,后续可以尝试更多模块的探索,具体可以参考官方主题。