1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. 2 // Use of this source code is governed by a BSD-style license that can be 3 // found in the LICENSE file. 4 5 #ifndef BASE_FILE_VERSION_INFO_H_ 6 #define BASE_FILE_VERSION_INFO_H_ 7 8 #include "build/build_config.h" 9 10 #if defined(OS_WIN) 11 #include <windows.h> 12 // http://blogs.msdn.com/oldnewthing/archive/2004/10/25/247180.aspx 13 extern "C" IMAGE_DOS_HEADER __ImageBase; 14 #endif // OS_WIN 15 16 #include <string> 17 18 #include "base/base_export.h" 19 #include "base/strings/string16.h" 20 21 namespace base { 22 class FilePath; 23 } 24 25 // Provides an interface for accessing the version information for a file. This 26 // is the information you access when you select a file in the Windows Explorer, 27 // right-click select Properties, then click the Version tab, and on the Mac 28 // when you select a file in the Finder and do a Get Info. 29 // 30 // This list of properties is straight out of Win32's VerQueryValue 31 // <http://msdn.microsoft.com/en-us/library/ms647464.aspx> and the Mac 32 // version returns values from the Info.plist as appropriate. TODO(avi): make 33 // this a less-obvious Windows-ism. 34 35 #if defined(OS_WIN) 36 // Creates a FileVersionInfo for the current module. Returns NULL in case of 37 // error. The returned object should be deleted when you are done with it. This 38 // is done as a macro to force inlining of __ImageBase. It used to be inside of 39 // a method labeled with __forceinline, but inlining through __forceinline 40 // stopped working for Debug builds in VS2013 (http://crbug.com/516359). 41 #define CREATE_FILE_VERSION_INFO_FOR_CURRENT_MODULE() \ 42 FileVersionInfo::CreateFileVersionInfoForModule( \ 43 reinterpret_cast<HMODULE>(&__ImageBase)) 44 #endif 45 46 class BASE_EXPORT FileVersionInfo { 47 public: ~FileVersionInfo()48 virtual ~FileVersionInfo() {} 49 #if defined(OS_WIN) || defined(OS_MACOSX) 50 // Creates a FileVersionInfo for the specified path. Returns NULL if something 51 // goes wrong (typically the file does not exit or cannot be opened). The 52 // returned object should be deleted when you are done with it. 53 static FileVersionInfo* CreateFileVersionInfo( 54 const base::FilePath& file_path); 55 #endif // OS_WIN || OS_MACOSX 56 57 #if defined(OS_WIN) 58 // Creates a FileVersionInfo for the specified module. Returns NULL in case 59 // of error. The returned object should be deleted when you are done with it. 60 // See CREATE_FILE_VERSION_INFO_FOR_CURRENT_MODULE() helper above for a 61 // CreateFileVersionInfoForCurrentModule() alternative for Windows. 62 static FileVersionInfo* CreateFileVersionInfoForModule(HMODULE module); 63 #else 64 // Creates a FileVersionInfo for the current module. Returns NULL in case 65 // of error. The returned object should be deleted when you are done with it. 66 static FileVersionInfo* CreateFileVersionInfoForCurrentModule(); 67 #endif // OS_WIN 68 69 // Accessors to the different version properties. 70 // Returns an empty string if the property is not found. 71 virtual base::string16 company_name() = 0; 72 virtual base::string16 company_short_name() = 0; 73 virtual base::string16 product_name() = 0; 74 virtual base::string16 product_short_name() = 0; 75 virtual base::string16 internal_name() = 0; 76 virtual base::string16 product_version() = 0; 77 virtual base::string16 private_build() = 0; 78 virtual base::string16 special_build() = 0; 79 virtual base::string16 comments() = 0; 80 virtual base::string16 original_filename() = 0; 81 virtual base::string16 file_description() = 0; 82 virtual base::string16 file_version() = 0; 83 virtual base::string16 legal_copyright() = 0; 84 virtual base::string16 legal_trademarks() = 0; 85 virtual base::string16 last_change() = 0; 86 virtual bool is_official_build() = 0; 87 }; 88 89 #endif // BASE_FILE_VERSION_INFO_H_ 90