base/android/build_info.h

   1 // Copyright (c) 2012 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_ANDROID_BUILD_INFO_H_
   6 #define BASE_ANDROID_BUILD_INFO_H_
   7
   8 #include <jni.h>
   9
  10 #include <string>
  11
  12 #include "base/base_export.h"
  13 #include "base/memory/singleton.h"
  14
  15 namespace base {
  16 namespace android {
  17
  18 // BuildInfo is a singleton class that stores android build and device
  19 // information. It will be called from Android specific code and gets used
  20 // primarily in crash reporting.
  21
  22 // It is also used to store the last java exception seen during JNI.
  23 // TODO(nileshagrawal): Find a better place to store this info.
  24 class BASE_EXPORT BuildInfo {
  25  public:
  26
  27   ~BuildInfo() {}
  28
  29   // Static factory method for getting the singleton BuildInfo instance.
  30   // Note that ownership is not conferred on the caller and the BuildInfo in
  31   // question isn't actually freed until shutdown. This is ok because there
  32   // should only be one instance of BuildInfo ever created.
  33   static BuildInfo* GetInstance();
  34
  35   // Const char* is used instead of std::strings because these values must be
  36   // available even if the process is in a crash state. Sadly
  37   // std::string.c_str() doesn't guarantee that memory won't be allocated when
  38   // it is called.
  39   const char* device() const {
  40     return device_;
  41   }
  42
  43   const char* model() const {
  44     return model_;
  45   }
  46
  47   const char* brand() const {
  48     return brand_;
  49   }
  50
  51   const char* android_build_id() const {
  52     return android_build_id_;
  53   }
  54
  55   const char* android_build_fp() const {
  56     return android_build_fp_;
  57   }
  58
  59   const char* package_version_code() const {
  60     return package_version_code_;
  61   }
  62
  63   const char* package_version_name() const {
  64     return package_version_name_;
  65   }
  66
  67   const char* package_label() const {
  68     return package_label_;
  69   }
  70
  71   const char* package_name() const {
  72     return package_name_;
  73   }
  74
  75   int sdk_int() const {
  76     return sdk_int_;
  77   }
  78
  79   const char* java_exception_info() const {
  80     return java_exception_info_;
  81   }
  82
  83   void set_java_exception_info(const std::string& info);
  84
  85   static bool RegisterBindings(JNIEnv* env);
  86
  87  private:
  88   friend struct BuildInfoSingletonTraits;
  89
  90   explicit BuildInfo(JNIEnv* env);
  91
  92   // Const char* is used instead of std::strings because these values must be
  93   // available even if the process is in a crash state. Sadly
  94   // std::string.c_str() doesn't guarantee that memory won't be allocated when
  95   // it is called.
  96   const char* const device_;
  97   const char* const model_;
  98   const char* const brand_;
  99   const char* const android_build_id_;
 100   const char* const android_build_fp_;
 101   const char* const package_version_code_;
 102   const char* const package_version_name_;
 103   const char* const package_label_;
 104   const char* const package_name_;
 105   const int sdk_int_;
 106   // This is set via set_java_exception_info, not at constructor time.
 107   const char* java_exception_info_;
 108
 109   DISALLOW_COPY_AND_ASSIGN(BuildInfo);
 110 };
 111
 112 }  // namespace android
 113 }  // namespace base
 114
 115 #endif  // BASE_ANDROID_BUILD_INFO_H_