<parameter
id=“activityClass”
name=“Activity Name”
type=“string”
constraints=“class|unique|nonempty”
suggest=“${layoutToActivity(layoutName)}”
default=“MainActivity”
help=“The name of the activity class to create” />
…
template_blank_activity.png
我们挑出其中的重点来说
表示当前的这个模版的分类,当前的 Value 是 Activity ,就表示它会出现在 File -> New -> Activity 中,这个是可以自定义的.
template_blank_activity.png
thumbs 用于指定创建模版时所展示出来的图片
而最重要的,还是 parameter 代码块的内容了,在这之中,我们只需要关注以下几个,其他的顾名思义即可。
<parameter
id=“activityClass”
name=“Activity Name”
type=“string”
constraints=“class|unique|nonempty”
suggest=“${layoutToActivity(layoutName)}”
default=“MainActivity”
help=“The name of the activity class to create” />
activityClass 表示所要创建的 Activity ,其中 default 为默认名。
<parameter
id=“generateLayout”
name=“Generate Layout File”
type=“boolean”
default=“true”
help=“If true, a layout file will be generated” />
上面的代码块表示是否同时自动创建一个Activity对应的布局
<parameter
id=“layoutName”
name=“Layout Name”
type=“string”
constraints=“layout|unique|nonempty”
suggest=“${activityToLayout(activityClass)}”
default=“activity_main”
visibility=“generateLayout”
help=“The name of the layout to create for the activity” />
layoutName 则表示布局的名字,这里的 suggest 属性所填写的内容即为布局名,**${activityToLayout(activityClass)}**则为跟随Activity的名字,其中 activityClass 是Activity名字的引用
剩下的不用再作说明,基本上可以见名知意。
模版代码
====
接下来我们从 EmptyActivity 中的 root 目录一直进入,直到看到下面两个文件
可以看到,一个后缀是 java.ftl 另外一个后缀是 kt.ftl,他们分别用于创建 Java模版与Kotlin模版,如果你暂时不使用Kotlin的话,可以不用去关心 Kotlin模版,当你完成了Java模版的编写,也可以使用 Android Studio自带的转换功能,还是蛮方便的。
下面来看一下Java的模版代码:
package ${packageName};
import ${superClassFqcn};
import android.os.Bundle;
<#if (includeCppSupport!false) && generateLayout>
import android.widget.TextView;
</#if>
public class ${activityClass} extends ${superClass} {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
<#if generateLayout>
setContentView(R.layout.${layoutName});
<#include “…/…/…/…/common/jni_code_usage.java.ftl”>
<#elseif includeCppSupport!false>
// Example of a call to a native method
android.util.Log.d(“${activityClass}”, stringFromJNI());
</#if>
}
<#include “…/…/…/…/common/jni_code_snippet.java.ftl”>
}
-
${packageName}:表示当前包名
-
${activityClass}:表示当前的Activity名字
-
{superClassFqcn}
-
${layoutName}:当前Activity所对应的布局名
目前我们只需要关注上面这部分,接下来可以看一下我们实际想要创建的MVP结构:
编写模版代码前,最好的方式是先写一遍例子,然后对照例子去替换关键名部分,这样做是最轻松的。
下面就来看一看具体的实现吧:
样例代码
====
接口部分:TestActivityContact
package com.example.testcustomtemplates.contact;
public interface TestActivityContact {
interface Presenter {
void succeed(T t);
void failed(T t);
void error(Throwable e);
void subscribe();
void unSubscribe();
}
interface View {
void setPresenter(Presenter presenter);
void succeed(T t);
void failed(T t);
void error(Throwable e);
}
interface Model {
void setPresenter(Presenter presenter);
}
}
为了方便测试,这里并没有另外创建一些基类接口,可以看到上面代码中分别对应 MVP 结构中三个模块的接口,写的是最基本的需求方法,不过 MVP 也不都是完全一样的,这里你可以定义自己想写的方法。
Model层:TestActivityModel
package com.example.testcustomtemplates.model;
import android.content.Context;
import com.example.testcustomtemplates.contact.TestActivityContact;
public class TestActivityModel implements TestActivityContact.Model {
private Context context;
private TestActivityContact.Presenter mPresenter;
public TestActivityModel(Context context) {
this.context = context;
}
@Override
public void setPresenter(TestActivityContact.Presenter presenter) {
this.mPresenter = presenter;
}
}
Model层主要就是做一些网络请求,存储之类的数据相关操作,不可以持有对View的引用,他是通过Presenter去和View进行交互的。
Presenter层:TestActivityPresenter
package com.example.testcustomtemplates.presenter;
import android.content.Context;
import com.example.testcustomtemplates.contact.TestActivityContact;
import com.example.testcustomtemplates.model.TestActivityModel;
public class TestActivityPresenter implements TestActivityContact.Presenter {
private TestActivityContact.View mView;
private TestActivityModel mModel;
private Context context;
public TestActivityPresenter(TestActivityContact.View mView, Context context) {
this.mView = mView;
this.context = context;
mModel = new TestActivityModel(context);
}
@Override
public void succeed(T t) {
}
@Override
public void failed(T t) {
}
@Override
public void error(Throwable e) {
}
@Override
public void subscribe() {
}
@Override
public void unSubscribe() {
}
}
Presenter层自然不必多说,他最好是不要持有View控件的引用,大部分的逻辑操作需要他来完成,不过不可避免的,如果业务逻辑复杂了,Presenter层也会变得臃肿,这也是MVP结构的一个短处。
View层:TestActivity
package com.example.testcustomtemplates.activity;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import com.example.testcustomtemplates.R;
import com.example.testcustomtemplates.contact.TestActivityContact;
import com.example.testcustomtemplates.presenter.TestActivityPresenter;
public class TestActivity extends AppCompatActivity implements TestActivityContact.View {
private TestActivityContact.Presenter mPresenter;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_test);
new TestActivityPresenter(this, this);
}
@Override
public void setPresenter(TestActivityContact.Presenter presenter) {
this.mPresenter = presenter;
}
@Override
public void succeed(T t) {
}
@Override
public void failed(T t) {
}
@Override
public void error(Throwable e) {
}
}
Activity或者Fragment都可以用作View层,这层主要是对一些视图控件的状态进行切换,不做复杂的逻辑操作。
看完上面的这些代码后,其实就可以开始直接编写我们的模版代码了。
模版编写
====
首先,可以Copy一份 EmptyActivity 整个模版的文件,然后改一下名字,随便什么都可以,这里我将其改成 MvpDemoActivity
然后我们首先对 template.xml 文件进行修改,主要修改下面这个部分:
然后是对 recipe.xml.ftl 文件进行修改,修改后如下:
<?xml version="1.0"?><#import “root://activities/common/kotlin_macros.ftl” as kt>
<#include “…/common/recipe_manifest.xml.ftl” />
<@kt.addAllKotlinDependencies />
<#if generateLayout>
<#include “…/common/recipe_simple.xml.ftl” />
</#if>
<instantiate from=“root/src/app_package/MvpActivity.java.ftl”
to=“ e s c a p e X m l A t t r i b u t e ( s r c O u t ) / a c t i v i t y / {escapeXmlAttribute(srcOut)}/activity/ escapeXmlAttribute(srcOut)/activity/{activityClass}.java” />