首页 > 编程语言 > AndroidStudio4.1 自定义模板的使用方法
2021
01-21

AndroidStudio4.1 自定义模板的使用方法

AndroidStudio4.0之前,可以在template的文件夹里使用freemarker的自定义模板,可以在AndroidStudio的文件夹中,随意的添加适合自己的自定义模板

但是从4.1版本开始提供新的方式,Geminio,用Kotlin的形式编写新的template,而且需要使用插件的形式,才能使用自定义的模板,摸索了好几天,终于解决了。

我的项目是使用MVVM的开发框架,每次在编写一个新的页面的时候,就需要新建四个文件Activity/Fragment, ViewModel, Repository, xml文件,写的多了就会很烦。自从使用了自定义的模板以后,头发掉得都少了。

开工!!!搞起!!!

准备

开发工具 AndroidStudio4.1

模板基础代码配置

打开 https://github.com/JetBrains/intellij-platform-plugin-template,点击绿色的#Use this template#,按步骤在自己的github上创建模板。

然后使用AndroidStudio 将模板下载到本地。

 

编码

添加wizard-template.jar

在根目录里添加lib文件夹,并添加AndroidStudio安装目录里的wizard-template.jar,位于 /Applications/Android\ Studio.app/Contents/plugins/android/lib/目录下。

修改build.gradle.kts

在dependencies里添加wizard-template.jar的依赖

dependencies {
  detektPlugins("io.gitlab.arturbosch.detekt:detekt-formatting:1.15.0")
  compileOnly(files("lib/wizard-template.jar"))
}

修改gradle.properties

修改gradle.properties中的pluginGroup, pluginName_, platformPlugins, platformVersion。

pluginGroup = com.bigaddemo.mvvm
pluginName_ = bigaddemo_MVVM
platformVersion = 2020.2
platformPlugins = java, com.intellij.java, org.jetbrains.android, android, org.jetbrains.kotlin

将默认的listeners的父包名,调整为自己想要的样子,例如com.company.app

修改MyProjectManagerListener

internal class MyProjectManagerListener : ProjectManagerListener {

 override fun projectOpened(project: Project) {
  projectInstance = project
  project.getService(MyProjectService::class.java)
 }

 override fun projectClosing(project: Project) {
  projectInstance = null
  super.projectClosing(project)
 }

 companion object {
  var projectInstance: Project? = null
 }
}

在src/main/kotlin里创建other文件夹用于放置自定义模板

正式开始编写自定义模板,以Activity为例。

1. 实现WizardTemplateProvider

SamplePluginTemplateProviderImpl

package other
import com.android.tools.idea.wizard.template.Template
import com.android.tools.idea.wizard.template.WizardTemplateProvider
import other.mvvm.activity.mvvmActivityTemplate
import other.mvvm.fragment.mvvmFragmentTemplate
class SamplePluginTemplateProviderImpl : WizardTemplateProvider() {

 override fun getTemplates(): List<Template> = listOf(
   // activity的模板
   mvvmActivityTemplate,
   // fragment的模板
   mvvmFragmentTemplate
 )
}

2. 创建 mvvmActivityTemplate.kt.

这个文件是设置在创建Activity的时候,输入的信息,例如ActivityName,layoutName,packageName以及是否可以为为等

mvvmActivityTemplate.kt

package other
import com.android.tools.idea.wizard.template.Template
import com.android.tools.idea.wizard.template.WizardTemplateProvider
import other.mvvm.activity.mvvmActivityTemplate
import other.mvvm.fragment.mvvmFragmentTemplate
class SamplePluginTemplateProviderImpl : WizardTemplateProvider() {

 override fun getTemplates(): List<Template> = listOf(
   // activity的模板
   mvvmActivityTemplate,
   // fragment的模板
   mvvmFragmentTemplate
 )
}

3. 创建mvvmActivityRecipe.kt。

这个文件用于将创建的文件保存到文件夹中,例如Activity,布局文件等。 原计划将Activity直接添加到AndroidManifest里,但是发现generateManifest有点问题,导致生成的插件不能使用,暂时去掉,只能手动添加了。

mvvmActivityRecipe.kt

package other.mvvm.activity

import com.android.tools.idea.wizard.template.ModuleTemplateData
import com.android.tools.idea.wizard.template.RecipeExecutor
import other.mvvm.activity.res.layout.mvvmActivityXml
import other.mvvm.activity.src.app_package.mvvmAcitivityKt
import other.mvvm.activity.src.app_package.mvvmRepository
import other.mvvm.activity.src.app_package.mvvmViewModel


fun RecipeExecutor.mvvmActivityRecipe(
  moduleData: ModuleTemplateData,
  activityClass: String,
  layoutName: String,
  packageName: String
) {
 val (projectData, srcOut, resOut) = moduleData
 val ktOrJavaExt = projectData.language.extension
// generateManifest(
//   moduleData = moduleData,
//   activityClass = "${activityClass}Activity",
//   activityTitle = activityClass,
//   packageName = packageName,
//   isLauncher = false,
//   hasNoActionBar = false,
//   generateActivityTitle = true,
//   requireTheme = false,
//   useMaterial2 = false
// )

 val mvvmActivity = mvvmAcitivityKt(projectData.applicationPackage, activityClass, layoutName, packageName)
 // 保存Activity
 save(mvvmActivity, srcOut.resolve("${activityClass}Activity.${ktOrJavaExt}"))
 // 保存xml
 save(mvvmActivityXml(packageName, activityClass), resOut.resolve("layout/${layoutName}.xml"))
 // 保存viewmodel
 save(mvvmViewModel(packageName, activityClass), srcOut.resolve("${activityClass}ViewModel.${ktOrJavaExt}"))
 // 保存repository
 save(mvvmRepository(packageName, activityClass), srcOut.resolve("${activityClass}Repository.${ktOrJavaExt}"))
}

4. 创建mvvmAcitivityKt。

这个文件用于创建Activity的模板代码,根据自己的情况,自行调整。

mvvmAcitivityKt.kt

package other.mvvm.activity.src.app_package

fun mvvmAcitivityKt(
  applicationPackage:String?,
  activityClass:String,
  layoutName:String,
  packageName:String
)="""
package ${packageName}
import android.os.Bundle
import com.bigademo.baselib.base.BaseActivity
import ${applicationPackage}.R
import ${applicationPackage}.BR;
import ${applicationPackage}.databinding.Activity${activityClass}Binding
class ${activityClass}Activity : BaseActivity<${activityClass}ViewModel, Activity${activityClass}Binding>() {
 override fun getContentView(): Int {
  return R.layout.${layoutName}
 }

 override fun init(savedInstanceState: Bundle?) {
  super.init(savedInstanceState)
  isShowTopBar = false
 }

 override fun initViewModel() {
  viewModel = ${activityClass}ViewModel()
 }
 /**
  *	监听数据的变化
  */
 override fun observe() {

 }
 
 /**
  * 控件的点击事件
  */
 override fun onClick() {
 }

 override fun initData() {
  super.initData()
 }
 override fun initVariableId(): Int {
  TODO("Not yet implemented")
 }
 } 
"""

5. 编写mvvmRepository。

这个文件是mvvm的repository层的代码。

mvvmRepository.kt

package other.mvvm.activity.src.app_package

fun mvvmRepository(
  packageName:String,
  activityClass:String
)="""
package ${packageName}

import androidx.lifecycle.MutableLiveData
import com.shide.baselib.base.basemvvm.BaseRepository
import com.shide.baselib.base.basemvvm.BaseViewModel
import com.shide.baselib.net.exception.ShideApiException
import kotlinx.coroutines.CoroutineScope

class ${activityClass}Repository(
 baseViewModel: BaseViewModel,
 coroutineScope: CoroutineScope,
 errorLiveData: MutableLiveData<ShideApiException>
) : BaseRepository(baseViewModel, coroutineScope, errorLiveData) {
}
"""

6. 编写mvvmViewModel。这个是mvvm的viewmodel层 mvvmViewModel.kt

package other.mvvm.activity.src.app_package
fun mvvmViewModel(
  packageName:String,
  activityClass:String
)="""
package ${packageName}
import androidx.lifecycle.viewModelScope
import com.bigademo.baselib.base.basemvvm.BaseViewModel
class ${activityClass}ViewModel : BaseViewModel() {
 private val repo by lazy { ${activityClass}Repository(this, viewModelScope, errorLiveData) }
} 
"""

7.编写mvvmActivityXml。这个文件是用于生成布局文件的 mvvmActivityXml.kt

package other.mvvm.activity.res.layout

fun mvvmActivityXml(
  packageName: String,
  activityClass: String
) = """
<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android">

 <data>

 </data>
 
 <androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
 xmlns:app="http://schemas.android.com/apk/res-auto"
 xmlns:tools="http://schemas.android.com/tools"
 android:layout_width="match_parent"
 android:layout_height="match_parent"
 tools:context="${packageName}.${activityClass}Activity">
</androidx.constraintlayout.widget.ConstraintLayout>
</layout>

8. 修改plugin.xml

添加org.jetbrains.android,org.jetbrains.kotlin,com.intellij.modules.java的依赖

修改applicationService和projectService的值

修改applicationListenersv中listener的值

添加wizardTemplateProvider为刚才添加的类

<idea-plugin>
 <id>com.bigaddemo.mvvm</id>
 <name>bigaddemo_MVVM</name>
 <vendor>bigademo</vendor>

 <!-- Product and plugin compatibility requirements -->
 <!-- https://www.jetbrains.org/intellij/sdk/docs/basics/getting_started/plugin_compatibility.html -->
 <depends>org.jetbrains.android</depends>
 <depends>org.jetbrains.kotlin</depends>
 <depends>com.intellij.modules.java</depends>
 <depends>com.intellij.modules.platform</depends>

 <extensions defaultExtensionNs="com.intellij">
 <applicationService serviceImplementation="com.bigaddemo.mvvm.services.MyApplicationService" />
 <projectService serviceImplementation="com.bigaddemo.mvvm.services.MyProjectService" />
 </extensions>

 <applicationListeners>
 <listener class="com.bigaddemo.mvvm.listeners.MyProjectManagerListener" topic="com.intellij.openapi.project.ProjectManagerListener" />
 </applicationListeners>

 <extensions defaultExtensionNs="com.android.tools.idea.wizard.template">
 <wizardTemplateProvider implementation="other.SamplePluginTemplateProviderImpl" />
 </extensions>
</idea-plugin>

生成jar文件

在AS最上面选择运行 Run plugin ,成功以后即可在build/libs找见对应的jar文件。最后在AS的设置里将这个jar包添加的plugin,重启AS即可。

 

到此这篇关于AndroidStudio4.1 自定义模板的使用方法的文章就介绍到这了,更多相关AndroidStudio4.1 自定义模板内容请搜索自学编程网以前的文章或继续浏览下面的相关文章希望大家以后多多支持自学编程网!

编程技巧