diff options
Diffstat (limited to 'sdkmanager/libs/sdklib/src/com/android/sdklib/devices/Device.java')
| -rw-r--r-- | sdkmanager/libs/sdklib/src/com/android/sdklib/devices/Device.java | 295 |
1 files changed, 0 insertions, 295 deletions
diff --git a/sdkmanager/libs/sdklib/src/com/android/sdklib/devices/Device.java b/sdkmanager/libs/sdklib/src/com/android/sdklib/devices/Device.java deleted file mode 100644 index cb712f0..0000000 --- a/sdkmanager/libs/sdklib/src/com/android/sdklib/devices/Device.java +++ /dev/null @@ -1,295 +0,0 @@ -/* - * Copyright (C) 2012 The Android Open Source Project - * - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - */ - -package com.android.sdklib.devices; - -import com.android.dvlib.DeviceSchema; - -import java.util.ArrayList; -import java.util.Collection; -import java.util.Collections; -import java.util.List; - -/** - * Instances of this class contain the specifications for a device. Use the - * {@link Builder} class to construct a Device object, or the - * {@link DeviceParser} if constructing device objects from XML conforming to - * the {@link DeviceSchema} standards. - */ -public final class Device { - /** Name of the device */ - private final String mName; - /** Manufacturer of the device */ - private final String mManufacturer; - /** A list of software capabilities, one for each API level range */ - private final List<Software> mSoftware; - /** A list of phone states (landscape, portrait with keyboard out, etc.) */ - private final List<State> mState; - /** Meta information such as icon files and device frames */ - private final Meta mMeta; - /** Default state of the device */ - private final State mDefaultState; - - /** - * Returns the name of the {@link Device}. - * - * @return The name of the {@link Device}. - */ - public String getName() { - return mName; - } - - /** - * Returns the manufacturer of the {@link Device}. - * - * @return The name of the manufacturer of the {@link Device}. - */ - public String getManufacturer() { - return mManufacturer; - } - - /** - * Returns all of the {@link Software} configurations of the {@link Device}. - * - * @return A list of all the {@link Software} configurations. - */ - public List<Software> getAllSoftware() { - return mSoftware; - } - - /** - * Returns all of the {@link State}s the {@link Device} can be in. - * - * @return A list of all the {@link State}s. - */ - public List<State> getAllStates() { - return mState; - } - - /** - * Returns the default {@link Hardware} configuration for the device. This - * is really just a shortcut for getting the {@link Hardware} on the default - * {@link State} - * - * @return The default {@link Hardware} for the device. - */ - public Hardware getDefaultHardware() { - return mDefaultState.getHardware(); - } - - /** - * Returns the {@link Meta} object for the device, which contains meta - * information about the device, such as the location of icons. - * - * @return The {@link Meta} object for the {@link Device}. - */ - public Meta getMeta() { - return mMeta; - } - - /** - * Returns the default {@link State} of the {@link Device}. - * - * @return The default {@link State} of the {@link Device}. - */ - public State getDefaultState() { - return mDefaultState; - } - - /** - * Returns the software configuration for the given API version. - * - * @param apiVersion - * The API version requested. - * @return The Software instance for the requested API version or null if - * the API version is unsupported for this device. - */ - public Software getSoftware(int apiVersion) { - for (Software s : mSoftware) { - if (apiVersion >= s.getMinSdkLevel() && apiVersion <= s.getMaxSdkLevel()) { - return s; - } - } - return null; - } - - /** - * Returns the state of the device with the given name. - * - * @param name - * The name of the state requested. - * @return The State object requested or null if there's no state with the - * given name. - */ - public State getState(String name) { - for (State s : getAllStates()) { - if (s.getName().equals(name)) { - return s; - } - } - return null; - } - - public static class Builder { - private String mName; - private String mManufacturer; - private final List<Software> mSoftware = new ArrayList<Software>(); - private final List<State> mState = new ArrayList<State>(); - private Meta mMeta; - private State mDefaultState; - - public Builder() { } - - public Builder(Device d) { - mName = d.getName(); - mManufacturer = d.getManufacturer(); - for (Software s : d.getAllSoftware()) { - mSoftware.add(s.deepCopy()); - } - for (State s : d.getAllStates()) { - mState.add(s.deepCopy()); - } - mSoftware.addAll(d.getAllSoftware()); - mState.addAll(d.getAllStates()); - mMeta = d.getMeta(); - mDefaultState = d.getDefaultState(); - } - - public void setName(String name) { - mName = name; - } - - public void setManufacturer(String manufacturer) { - mManufacturer = manufacturer; - } - - public void addSoftware(Software sw) { - mSoftware.add(sw); - } - - public void addAllSoftware(Collection<? extends Software> sw) { - mSoftware.addAll(sw); - } - - public void addState(State state) { - mState.add(state); - } - - public void addAllState(Collection<? extends State> states) { - mState.addAll(states); - } - - /** - * Removes the first {@link State} with the given name - * @param stateName The name of the {@link State} to remove. - * @return Whether a {@link State} was removed or not. - */ - public boolean removeState(String stateName) { - for (int i = 0; i < mState.size(); i++) { - if (stateName != null && stateName.equals(mState.get(i).getName())) { - mState.remove(i); - return true; - } - } - return false; - } - - public void setMeta(Meta meta) { - mMeta = meta; - } - - public Device build() { - if (mSoftware.size() <= 0) { - throw generateBuildException("Device software not configured"); - } else if (mState.size() <= 0) { - throw generateBuildException("Device states not configured"); - } - - if (mMeta == null) { - mMeta = new Meta(); - } - for (State s : mState) { - if (s.isDefaultState()) { - mDefaultState = s; - break; - } - } - return new Device(this); - } - - private IllegalStateException generateBuildException(String err) { - String device = ""; - if (mManufacturer != null) { - device = mManufacturer + " "; - } - if (mName != null) { - device += mName; - } else { - device = "Unknown " + device +"Device"; - } - - return new IllegalStateException("Error building " + device + ": " +err); - } - } - - protected Device(Builder b) { - mName = b.mName; - mManufacturer = b.mManufacturer; - mSoftware = Collections.unmodifiableList(b.mSoftware); - mState = Collections.unmodifiableList(b.mState); - mMeta = b.mMeta; - mDefaultState = b.mDefaultState; - } - - @Override - public boolean equals(Object o) { - if (o == this) { - return true; - } - if (!(o instanceof Device)) { - return false; - } - Device d = (Device) o; - return mName.equals(d.getName()) - && mManufacturer.equals(d.getManufacturer()) - && mSoftware.equals(d.getAllSoftware()) - && mState.equals(d.getAllStates()) - && mMeta.equals(d.getMeta()) - && mDefaultState.equals(d.getDefaultState()); - } - - @Override - /** A hash that's stable across JVM instances */ - public int hashCode() { - int hash = 17; - for (Character c : mName.toCharArray()) { - hash = 31 * hash + c; - } - for (Character c : mManufacturer.toCharArray()) { - hash = 31 * hash + c; - } - hash = 31 * hash + mSoftware.hashCode(); - hash = 31 * hash + mState.hashCode(); - hash = 31 * hash + mMeta.hashCode(); - hash = 31 * hash + mDefaultState.hashCode(); - return hash; - } - - @Override - public String toString() { - return mName; - } -} |