1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
|
#pragma once
#include "../coding/reader.hpp"
#include "../base/exception.hpp"
#include "../std/string.hpp"
#include "../std/vector.hpp"
#include "../std/utility.hpp"
#include "../std/function.hpp"
#include "../defines.hpp"
DECLARE_EXCEPTION(FileAbsentException, RootException);
DECLARE_EXCEPTION(NotImplementedException, RootException);
class Platform
{
protected:
/// Usually read-only directory for application resources
string m_resourcesDir;
/// Writable directory to store downloaded map data
/// @note on some systems it can point to external ejectable storage
string m_writableDir;
/// Temporary directory, can be cleaned up by the system
string m_tmpDir;
/// Writable directory to store persistent application data
string m_settingsDir;
/// Flag that it's a paid PRO version of app.
bool m_isPro;
class PlatformImpl;
/// Used only on those platforms where needed
PlatformImpl * m_impl;
/// Internal function to use files from writable dir
/// if they override the same file in the resources dir
string ReadPathForFile(string const & file) const;
/// Hash some unique string into uniform format.
static string HashUniqueID(string const & s);
public:
Platform();
~Platform();
static bool IsFileExistsByFullPath(string const & filePath);
/// @return always the same writable dir for current user with slash at the end
string WritableDir() const { return m_writableDir; }
/// @return full path to file in user's writable directory
string WritablePathForFile(string const & file) const { return WritableDir() + file; }
/// @return resource dir (on some platforms it's differ from Writable dir)
string ResourcesDir() const { return m_resourcesDir; }
/// @return path for directory with temporary files with slash at the end
string TmpDir() const { return m_tmpDir; }
/// @return full path to file in the temporary directory
string TmpPathForFile(string const & file) const { return TmpDir() + file; }
/// @return path for directory in the persistent memory, can be the same
/// as WritableDir, but on some platforms it's different
string SettingsDir() const { return m_settingsDir; }
/// @return full path to file in the settings directory
string SettingsPathForFile(string const & file) const { return SettingsDir() + file; }
/// @return reader for file decriptor.
/// @throws FileAbsentException
/// @param[in] file descriptor which we want to read
ModelReader * GetReader(string const & file) const;
/// @name File operations
//@{
typedef vector<string> FilesList;
/// Retrieves files list contained in given directory
/// @param directory directory path with slash at the end
//@{
/// @param ext files extension to find, like ".mwm".
static void GetFilesByExt(string const & directory, string const & ext, FilesList & outFiles);
static void GetFilesByRegExp(string const & directory, string const & regexp, FilesList & outFiles);
//@}
/// @return false if file is not exist
/// @note Check files in Writable dir first, and in ReadDir if not exist in Writable dir
bool GetFileSizeByName(string const & fileName, uint64_t & size) const;
/// @return false if file is not exist
/// @note Try do not use in client production code
static bool GetFileSizeByFullPath(string const & filePath, uint64_t & size);
//@}
/// Used to check available free storage space for downloading.
enum TStorageStatus
{
STORAGE_OK = 0,
STORAGE_DISCONNECTED,
NOT_ENOUGH_SPACE
};
TStorageStatus GetWritableStorageStatus(uint64_t neededSize);
/// @name Functions for concurrent tasks.
//@{
typedef function<void()> TFunctor;
void RunOnGuiThread(TFunctor const & fn);
enum Priority
{
EPriorityBackground,
EPriorityLow,
EPriorityDefault,
EPriorityHigh
};
void RunAsync(TFunctor const & fn, Priority p = EPriorityDefault);
//@}
int CpuCores() const;
void GetFontNames(FilesList & res) const;
int VideoMemoryLimit() const;
int PreCachingDepth() const;
string DeviceName() const;
int ScaleEtalonSize() const;
string UniqueClientId() const;
inline bool IsPro() const { return m_isPro; }
bool DoSupportRotation() const;
/// @return url for clients to download maps
//@{
string MetaServerUrl() const;
string ResourcesMetaServerUrl() const;
//@}
/// @return JSON-encoded list of urls if metaserver is unreachable
string DefaultUrlsJSON() const;
};
extern Platform & GetPlatform();
|