/* * Copyright (C) 2015 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. */ #ifndef AAPT_CONFIG_DESCRIPTION_H #define AAPT_CONFIG_DESCRIPTION_H #include #include "androidfw/ResourceTypes.h" #include "androidfw/StringPiece.h" namespace aapt { // Subclass of ResTable_config that adds convenient // initialization and comparison methods. struct ConfigDescription : public android::ResTable_config { // Returns an immutable default config. static const ConfigDescription& DefaultConfig(); // Parse a string of the form 'fr-sw600dp-land' and fill in the // given ResTable_config with resulting configuration parameters. // // The resulting configuration has the appropriate sdkVersion defined // for backwards compatibility. static bool Parse(const android::StringPiece& str, ConfigDescription* out = nullptr); // If the configuration uses an axis that was added after // the original Android release, make sure the SDK version // is set accordingly. static void ApplyVersionForCompatibility(ConfigDescription* config); ConfigDescription(); ConfigDescription(const android::ResTable_config& o); // NOLINT(implicit) ConfigDescription(const ConfigDescription& o); ConfigDescription(ConfigDescription&& o); ConfigDescription& operator=(const android::ResTable_config& o); ConfigDescription& operator=(const ConfigDescription& o); ConfigDescription& operator=(ConfigDescription&& o); ConfigDescription CopyWithoutSdkVersion() const; // A configuration X dominates another configuration Y, if X has at least the // precedence of Y and X is strictly more general than Y: for any type defined // by X, the same type is defined by Y with a value equal to or, in the case // of ranges, more specific than that of X. // // For example, the configuration 'en-w800dp' dominates 'en-rGB-w1024dp'. It // does not dominate 'fr', 'en-w720dp', or 'mcc001-en-w800dp'. bool Dominates(const ConfigDescription& o) const; // Returns true if this configuration defines a more important configuration // parameter than o. For example, "en" has higher precedence than "v23", // whereas "en" has the same precedence as "en-v23". bool HasHigherPrecedenceThan(const ConfigDescription& o) const; // A configuration conflicts with another configuration if both // configurations define an incompatible configuration parameter. An // incompatible configuration parameter is a non-range, non-density parameter // that is defined in both configurations as a different, non-default value. bool ConflictsWith(const ConfigDescription& o) const; // A configuration is compatible with another configuration if both // configurations can match a common concrete device configuration and are // unrelated by domination. For example, land-v11 conflicts with port-v21 // but is compatible with v21 (both land-v11 and v21 would match en-land-v23). bool IsCompatibleWith(const ConfigDescription& o) const; bool MatchWithDensity(const ConfigDescription& o) const; bool operator<(const ConfigDescription& o) const; bool operator<=(const ConfigDescription& o) const; bool operator==(const ConfigDescription& o) const; bool operator!=(const ConfigDescription& o) const; bool operator>=(const ConfigDescription& o) const; bool operator>(const ConfigDescription& o) const; }; ::std::ostream& operator<<(::std::ostream& out, const ConfigDescription& o); inline ConfigDescription::ConfigDescription() { memset(this, 0, sizeof(*this)); size = sizeof(android::ResTable_config); } inline ConfigDescription::ConfigDescription(const android::ResTable_config& o) { *static_cast(this) = o; size = sizeof(android::ResTable_config); } inline ConfigDescription::ConfigDescription(const ConfigDescription& o) { *static_cast(this) = o; } inline ConfigDescription::ConfigDescription(ConfigDescription&& o) { *this = o; } inline ConfigDescription& ConfigDescription::operator=(const android::ResTable_config& o) { *static_cast(this) = o; size = sizeof(android::ResTable_config); return *this; } inline ConfigDescription& ConfigDescription::operator=(const ConfigDescription& o) { *static_cast(this) = o; return *this; } inline ConfigDescription& ConfigDescription::operator=(ConfigDescription&& o) { *this = o; return *this; } inline bool ConfigDescription::MatchWithDensity(const ConfigDescription& o) const { return match(o) && (density == 0 || density == o.density); } inline bool ConfigDescription::operator<(const ConfigDescription& o) const { return compare(o) < 0; } inline bool ConfigDescription::operator<=(const ConfigDescription& o) const { return compare(o) <= 0; } inline bool ConfigDescription::operator==(const ConfigDescription& o) const { return compare(o) == 0; } inline bool ConfigDescription::operator!=(const ConfigDescription& o) const { return compare(o) != 0; } inline bool ConfigDescription::operator>=(const ConfigDescription& o) const { return compare(o) >= 0; } inline bool ConfigDescription::operator>(const ConfigDescription& o) const { return compare(o) > 0; } } // namespace aapt #endif // AAPT_CONFIG_DESCRIPTION_H