Home | History | Annotate | Download | only in view 
      1 /*
      2  * Copyright (C) 2008 The Android Open Source Project
      3  *
      4  * Licensed under the Apache License, Version 2.0 (the "License");
      5  * you may not use this file except in compliance with the License.
      6  * You may obtain a copy of the License at
      7  *
      8  *      http://www.apache.org/licenses/LICENSE-2.0
      9  *
     10  * Unless required by applicable law or agreed to in writing, software
     11  * distributed under the License is distributed on an "AS IS" BASIS,
     12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     13  * See the License for the specific language governing permissions and
     14  * limitations under the License.
     15  */
     16 
     17 package com.example.android.apis.view;
     18 
     19 import com.example.android.apis.R;
     20 
     21 import android.content.Context;
     22 import android.test.AndroidTestCase;
     23 import android.test.suitebuilder.annotation.SmallTest;
     24 import android.view.FocusFinder;
     25 import android.view.LayoutInflater;
     26 import android.view.View;
     27 import android.view.ViewGroup;
     28 import android.widget.Button;
     29 
     30 /**
     31  * This exercises the same logic as {@link Focus2ActivityTest} but in a lighter
     32  * weight manner; it doesn't need to launch the activity, and it can test the
     33  * focus behavior by calling {@link FocusFinder} methods directly.
     34  *
     35  * {@link Focus2ActivityTest} is still useful to verify that, at an end to end
     36  * level, key events actually translate to focus transitioning in the way we expect.
     37  * A good complementary way to use both types of tests might be to have more exhaustive
     38  * coverage in the lighter weight test case, and a few end to end scenarios in the
     39  * functional {@link android.test.ActivityInstrumentationTestCase}.  This would provide reasonable
     40  * assurance that the end to end system is working, while avoiding the overhead of
     41  * having every corner case exercised in the slower, heavier weight way.
     42  *
     43  * Even as a lighter weight test, this test still needs access to a {@link Context}
     44  * to inflate the file, which is why it extends {@link AndroidTestCase}.
     45  *
     46  * If you ever need a context to do your work in tests, you can extend
     47  * {@link AndroidTestCase}, and when run via an {@link android.test.InstrumentationTestRunner},
     48  * the context will be injected for you.
     49  *
     50  * See {@link com.example.android.apis.app.ForwardingTest} for an example of an Activity unit test.
     51  *
     52  * See {@link com.example.android.apis.AllTests} for documentation on running
     53  * all tests and individual tests in this application.
     54  */
     55 public class Focus2AndroidTest extends AndroidTestCase {
     56 
     57     private FocusFinder mFocusFinder;
     58 
     59     private ViewGroup mRoot;
     60 
     61     private Button mLeftButton;
     62     private Button mCenterButton;
     63     private Button mRightButton;
     64 
     65     @Override
     66     protected void setUp() throws Exception {
     67         super.setUp();
     68 
     69         mFocusFinder = FocusFinder.getInstance();
     70 
     71         // inflate the layout
     72         final Context context = getContext();
     73         final LayoutInflater inflater = LayoutInflater.from(context);
     74         mRoot = (ViewGroup) inflater.inflate(R.layout.focus_2, null);
     75 
     76         // manually measure it, and lay it out
     77         mRoot.measure(500, 500);
     78         mRoot.layout(0, 0, 500, 500);
     79 
     80         mLeftButton = (Button) mRoot.findViewById(R.id.leftButton);
     81         mCenterButton = (Button) mRoot.findViewById(R.id.centerButton);
     82         mRightButton = (Button) mRoot.findViewById(R.id.rightButton);
     83     }
     84 
     85     /**
     86      * The name 'test preconditions' is a convention to signal that if this
     87      * test doesn't pass, the test case was not set up properly and it might
     88      * explain any and all failures in other tests.  This is not guaranteed
     89      * to run before other tests, as junit uses reflection to find the tests.
     90      */
     91     @SmallTest
     92     public void testPreconditions() {
     93         assertNotNull(mLeftButton);
     94         assertTrue("center button should be right of left button",
     95                 mLeftButton.getRight() < mCenterButton.getLeft());
     96         assertTrue("right button should be right of center button",
     97                 mCenterButton.getRight() < mRightButton.getLeft());
     98     }
     99 
    100     @SmallTest
    101     public void testGoingRightFromLeftButtonJumpsOverCenterToRight() {
    102         assertEquals("right should be next focus from left",
    103                 mRightButton,
    104                 mFocusFinder.findNextFocus(mRoot, mLeftButton, View.FOCUS_RIGHT));
    105     }
    106 
    107     @SmallTest
    108     public void testGoingLeftFromRightButtonGoesToCenter() {
    109         assertEquals("center should be next focus from right",
    110                 mCenterButton,
    111                 mFocusFinder.findNextFocus(mRoot, mRightButton, View.FOCUS_LEFT));
    112     }
    113 }
    114