/* * Copyright (C) 2011 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 ART_RUNTIME_COMMON_RUNTIME_TEST_H_ #define ART_RUNTIME_COMMON_RUNTIME_TEST_H_ #include <gtest/gtest.h> #include <jni.h> #include <string> #include "arch/instruction_set.h" #include "base/mutex.h" #include "globals.h" // TODO: Add inl file and avoid including inl. #include "obj_ptr-inl.h" #include "os.h" namespace art { // OBJ pointer helpers to avoid needing .Decode everywhere. #define EXPECT_OBJ_PTR_EQ(a, b) EXPECT_EQ(MakeObjPtr(a).Ptr(), MakeObjPtr(b).Ptr()); #define ASSERT_OBJ_PTR_EQ(a, b) ASSERT_EQ(MakeObjPtr(a).Ptr(), MakeObjPtr(b).Ptr()); #define EXPECT_OBJ_PTR_NE(a, b) EXPECT_NE(MakeObjPtr(a).Ptr(), MakeObjPtr(b).Ptr()); #define ASSERT_OBJ_PTR_NE(a, b) ASSERT_NE(MakeObjPtr(a).Ptr(), MakeObjPtr(b).Ptr()); class ClassLinker; class CompilerCallbacks; class DexFile; class JavaVMExt; class Runtime; typedef std::vector<std::pair<std::string, const void*>> RuntimeOptions; uint8_t* DecodeBase64(const char* src, size_t* dst_size); class ScratchFile { public: ScratchFile(); explicit ScratchFile(const std::string& filename); ScratchFile(const ScratchFile& other, const char* suffix); ScratchFile(ScratchFile&& other); ScratchFile& operator=(ScratchFile&& other); explicit ScratchFile(File* file); ~ScratchFile(); const std::string& GetFilename() const { return filename_; } File* GetFile() const { return file_.get(); } int GetFd() const; void Close(); void Unlink(); private: std::string filename_; std::unique_ptr<File> file_; }; class CommonRuntimeTestImpl { public: CommonRuntimeTestImpl(); virtual ~CommonRuntimeTestImpl(); static void SetUpAndroidRoot(); // Note: setting up ANDROID_DATA may create a temporary directory. If this is used in a // non-derived class, be sure to also call the corresponding tear-down below. static void SetUpAndroidData(std::string& android_data); static void TearDownAndroidData(const std::string& android_data, bool fail_on_error); // Gets the paths of the libcore dex files. static std::vector<std::string> GetLibCoreDexFileNames(); // Returns bin directory which contains host's prebuild tools. static std::string GetAndroidHostToolsDir(); // Returns bin directory wahich contains target's prebuild tools. static std::string GetAndroidTargetToolsDir(InstructionSet isa); protected: // Allow subclases such as CommonCompilerTest to add extra options. virtual void SetUpRuntimeOptions(RuntimeOptions* options ATTRIBUTE_UNUSED) {} // Called before the runtime is created. virtual void PreRuntimeCreate() {} // Called after the runtime is created. virtual void PostRuntimeCreate() {} static bool IsHost() { return !kIsTargetBuild; } // File location to core.art, e.g. $ANDROID_HOST_OUT/system/framework/core.art static std::string GetCoreArtLocation(); // File location to core.oat, e.g. $ANDROID_HOST_OUT/system/framework/core.oat static std::string GetCoreOatLocation(); std::unique_ptr<const DexFile> LoadExpectSingleDexFile(const char* location); void ClearDirectory(const char* dirpath); std::string GetTestAndroidRoot(); std::string GetTestDexFileName(const char* name) const; std::vector<std::unique_ptr<const DexFile>> OpenTestDexFiles(const char* name); std::unique_ptr<const DexFile> OpenTestDexFile(const char* name) REQUIRES_SHARED(Locks::mutator_lock_); jobject LoadDex(const char* dex_name) REQUIRES_SHARED(Locks::mutator_lock_); jobject LoadMultiDex(const char* first_dex_name, const char* second_dex_name) REQUIRES_SHARED(Locks::mutator_lock_); std::string android_data_; std::string dalvik_cache_; std::unique_ptr<Runtime> runtime_; // The class_linker_, java_lang_dex_file_, and boot_class_path_ are all // owned by the runtime. ClassLinker* class_linker_; const DexFile* java_lang_dex_file_; std::vector<const DexFile*> boot_class_path_; // Get the dex files from a PathClassLoader. This in order of the dex elements and their dex // arrays. std::vector<const DexFile*> GetDexFiles(jobject jclass_loader); // Get the first dex file from a PathClassLoader. Will abort if it is null. const DexFile* GetFirstDexFile(jobject jclass_loader); std::unique_ptr<CompilerCallbacks> callbacks_; virtual void SetUp(); virtual void TearDown(); // Called to finish up runtime creation and filling test fields. By default runs root // initializers, initialize well-known classes, and creates the heap thread pool. virtual void FinalizeSetup(); private: static std::string GetCoreFileLocation(const char* suffix); std::vector<std::unique_ptr<const DexFile>> loaded_dex_files_; }; template <typename TestType> class CommonRuntimeTestBase : public TestType, public CommonRuntimeTestImpl { public: CommonRuntimeTestBase() {} virtual ~CommonRuntimeTestBase() {} protected: virtual void SetUp() OVERRIDE { CommonRuntimeTestImpl::SetUp(); } virtual void TearDown() OVERRIDE { CommonRuntimeTestImpl::TearDown(); } }; using CommonRuntimeTest = CommonRuntimeTestBase<testing::Test>; template <typename Param> using CommonRuntimeTestWithParam = CommonRuntimeTestBase<testing::TestWithParam<Param>>; // Sets a CheckJni abort hook to catch failures. Note that this will cause CheckJNI to carry on // rather than aborting, so be careful! class CheckJniAbortCatcher { public: CheckJniAbortCatcher(); ~CheckJniAbortCatcher(); void Check(const std::string& expected_text); void Check(const char* expected_text); private: static void Hook(void* data, const std::string& reason); JavaVMExt* const vm_; std::string actual_; DISALLOW_COPY_AND_ASSIGN(CheckJniAbortCatcher); }; #define TEST_DISABLED_FOR_TARGET() \ if (kIsTargetBuild) { \ printf("WARNING: TEST DISABLED FOR TARGET\n"); \ return; \ } #define TEST_DISABLED_FOR_MIPS() \ if (kRuntimeISA == kMips) { \ printf("WARNING: TEST DISABLED FOR MIPS\n"); \ return; \ } #define TEST_DISABLED_FOR_X86() \ if (kRuntimeISA == kX86) { \ printf("WARNING: TEST DISABLED FOR X86\n"); \ return; \ } #define TEST_DISABLED_FOR_STRING_COMPRESSION() \ if (mirror::kUseStringCompression) { \ printf("WARNING: TEST DISABLED FOR STRING COMPRESSION\n"); \ return; \ } #define TEST_DISABLED_FOR_NON_STATIC_HOST_BUILDS() \ if (!kHostStaticBuildEnabled) { \ printf("WARNING: TEST DISABLED FOR NON-STATIC HOST BUILDS\n"); \ return; \ } } // namespace art namespace std { // TODO: isn't gtest supposed to be able to print STL types for itself? template <typename T> std::ostream& operator<<(std::ostream& os, const std::vector<T>& rhs); } // namespace std #endif // ART_RUNTIME_COMMON_RUNTIME_TEST_H_