AndroidAnnotations——Enhance Fragments 优化Fragments

来源:互联网 发布:青少年禁毒网络大赛 编辑:程序博客网 时间:2024/05/16 05:27
AndroidAnnotation

目录(?)[+]

  1. Enhance Fragments 优化Fragments
    1. Support for FragmentActivity 对FragmentActivity的支持
    2. Fragment Support Fragment支持
      1. Enhanced Fragments 优化Fragments
      2. Fragment Layout Fragment布局
      3. Injecting Fragments 注入Fragments
  2. 本文档的简单示例下载

Enhance Fragments 优化Fragments


Support for FragmentActivity 对FragmentActivity的支持

Since AndroidAnnotations 2.1

Prior to AndroidAnnotations 2.6, there was no support for fragment injection. However, we made sure that at least extendingFragmentActivity instead of Activity didn't break AndroidAnnotations:
AndroidAnnotations2.6之前,并没有对fragment注入的支持。但是我们保证至少继承FragmentActivity代替Activity不会削弱AndroidAnnotations:
@EActivity(R.id.main)public class DetailsActivity extends FragmentActivity {}

Fragment Support Fragment支持

Since AndroidAnnotations 2.6

AndroidAnnotations supports both android.app.Fragment andandroid.support.v4.app.Fragment, and automatically uses the right APIs based on the fragment types. AndroidAnnotations支持android.app.Fragmentandroid.support.v4.app.Fragment,并且基于fragment类型自动使用正确的API。

Enhanced Fragments 优化Fragments

To start using AndroidAnnotations features in a fragment, annotate it with @EFragment:在fragment中使用AndroidAnnotations需要给它加@EFragment注解:

@EFragmentpublic class MyFragment extends Fragment {}

AndroidAnnotations will generate a fragment subclass with a trailing underscore, e.g.MyFragment_. You should use the generated subclass in your xml layouts and when creating new instance fragments:AndroidAnnotations将生成一个尾部带下划线的fragment子类,比如MyFragment_。你需要在布局xml文件和创建实例的时候使用生成的子类

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"    android:layout_width="fill_parent"    android:layout_height="fill_parent"    android:orientation="horizontal" >    <fragment        android:id="@+id/myFragment"        android:name="com.company.MyFragment_"        android:layout_width="fill_parent"        android:layout_height="fill_parent" /></LinearLayout>

Programmatically:代码方式:

MyFragment fragment = new MyFragment_();

You can now use all kind of annotations in your fragment:现在你可以在你的fragment中使用全部的注解:

@EFragmentpublic class MyFragment extends Fragment {        @Bean        SomeBean someBean;                @ViewById        TextView myTextView;        @App        MyApplication customApplication;                @SystemService        ActivityManager activityManager;                @Click        void myButton() {        }        @UiThread        void uiThread() {        }        @AfterInject        void calledAfterInjection() {        }                @AfterViews        void calledAfterViewInjection() {        }}
View injection and event listener binding will only be based on views contained inside the fragment. Note, however, that it's isn't currently the case for@EBean injected inside fragments: they have access to the activity views.
视图注入和事件监听绑定将仅仅基于包含在fragment中的视图。然而请注意,这不是 @EBean注入到fragment中的原因:它们有访问activity视图的权利。

Fragment Layout Fragment布局

The standard way to associate a view with a fragment is to override onCreateView():结合view和fragment的标准方法是重写onCreateView()函数:

@EFragmentpublic class MyFragment extends Fragment {    public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {        View view = inflater.inflate(R.layout.my_fragment_layout, container, false);        return view;    }}

You can let AndroidAnnotations handle that for you by setting the value param of the@EFragment annotation:你可以让AndroidAnnotations为你处理这种情况,它会设置@EFragment注解的 value 参数:

@EFragment(R.layout.my_fragment_layout)public class MyFragment extends Fragment {}

If you need to override onCreateView(), e.g. because you need to access savedInstanceState, you can still let AndroidAnnotations handle the layout creation by returningnull:如果你需要重写onCreateView()函数,可能因为你要使用savedInstanceState,你仍然可以让AndroidAnnotations通过返回 null来处理这个布局的创建:

@EFragment(R.layout.my_fragment_layout)public class MyFragment extends Fragment {    public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {        return null;    }}

Injecting Fragments 注入Fragments

You may inject fragments in classes annotated with @EActivity, @EFragment,@EView,@EViewGroup,@EBean, using @FragmentById or @FragmentByTag. If you don't specify any value on the annotation, the field name is used.你可能通过使用@FragmentById 或者@FragmentByTag将fragment注入到加了@EActivity,@EFragment,@EView,@EViewGroup,@EBean注解的类中。假如你没有指定任何值在注解上,将会使用默认字段名。

We recommend using @FragmentById rather then @FragmentByTag, because no compile time validation is performed for the latter.相对于@FragmentById,我们更推荐使用@FragmentByTag,因为后者不会执行编译时验证。

Please be aware that @FragmentById and @FragmentByTag can only inject fragments, not create them, so they must already exist in the activity (either by defining them in the layout or by creating them programmatically inonCreate().请注意, @FragmentById @FragmentByTag 只能注入到fragment中,而不能创建它们,所以它们在activity中必须已经存在(不论是在布局中定义或者在onCreate()代码中创建。

You can inject fragments even if they are not annotated with@EFragment.你可以注入fragment即使它们没有使用 @EFragment注解。

@EActivity(R.layout.fragments)public class MyFragmentActivity extends FragmentActivity {  @FragmentById  MyFragment myFragment;          @FragmentById(R.id.myFragment)  MyFragment myFragment2;          @FragmentByTag  MyFragment myFragmentTag;          @FragmentByTag("myFragmentTag")  MyFragment myFragmentTag2;}

本文档的简单示例下载

0 0