forked from flutter/engine
-
Notifications
You must be signed in to change notification settings - Fork 0
/
dart_vm_data.h
106 lines (91 loc) · 4.26 KB
/
dart_vm_data.h
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
// Copyright 2013 The Flutter Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef FLUTTER_RUNTIME_DART_VM_DATA_H_
#define FLUTTER_RUNTIME_DART_VM_DATA_H_
#include "flutter/fml/macros.h"
#include "flutter/runtime/dart_snapshot.h"
namespace flutter {
//------------------------------------------------------------------------------
/// @brief Provides thread-safe access to data that is necessary to
/// bootstrap a new Dart VM instance. All snapshots referenced by
/// this object are read-only.
///
class DartVMData {
public:
//----------------------------------------------------------------------------
/// @brief Creates a new instance of `DartVMData`. Both the VM and
/// isolate snapshot members are optional and may be `nullptr`. If
/// `nullptr`, the snapshot resolvers present in the settings
/// object are used to infer the snapshots. If the snapshots
/// cannot be inferred from the settings object, this method
/// return `nullptr`.
///
/// @param[in] settings The settings used to infer the VM and
/// isolate snapshots if they are not provided
/// directly.
/// @param[in] vm_snapshot The VM snapshot or `nullptr`.
/// @param[in] isolate_snapshot The isolate snapshot or `nullptr`.
///
/// @return A new instance of VM data that can be used to bootstrap a Dart
/// VM. `nullptr` if the snapshots are not provided and cannot be
/// inferred from the settings object.
///
static std::shared_ptr<const DartVMData> Create(
const Settings& settings,
fml::RefPtr<const DartSnapshot> vm_snapshot,
fml::RefPtr<const DartSnapshot> isolate_snapshot);
//----------------------------------------------------------------------------
/// @brief Collect the DartVMData instance.
///
~DartVMData();
//----------------------------------------------------------------------------
/// @brief The settings object from which the Dart snapshots were
/// inferred.
///
/// @return The settings.
///
const Settings& GetSettings() const;
//----------------------------------------------------------------------------
/// @brief Gets the VM snapshot. This can be in the call to bootstrap
/// the Dart VM via `Dart_Initialize`.
///
/// @return The VM snapshot.
///
const DartSnapshot& GetVMSnapshot() const;
//----------------------------------------------------------------------------
/// @brief Get the isolate snapshot necessary to launch isolates in the
/// Dart VM. The Dart VM instance in which these isolates are
/// launched must be the same as the VM created using snapshot
/// accessed via `GetVMSnapshot`.
///
/// @return The isolate snapshot.
///
fml::RefPtr<const DartSnapshot> GetIsolateSnapshot() const;
//----------------------------------------------------------------------------
/// @brief Get the isolate snapshot used to launch the service isolate
/// in the Dart VM.
///
/// @return The service isolate snapshot.
///
fml::RefPtr<const DartSnapshot> GetServiceIsolateSnapshot() const;
//----------------------------------------------------------------------------
/// @brief Returns whether the service isolate snapshot requires null
/// safety in the Dart_IsolateFlags used to create the isolate.
///
/// @return True if the snapshot requires null safety.
///
bool GetServiceIsolateSnapshotNullSafety() const;
private:
const Settings settings_;
const fml::RefPtr<const DartSnapshot> vm_snapshot_;
const fml::RefPtr<const DartSnapshot> isolate_snapshot_;
const fml::RefPtr<const DartSnapshot> service_isolate_snapshot_;
DartVMData(const Settings& settings,
fml::RefPtr<const DartSnapshot> vm_snapshot,
fml::RefPtr<const DartSnapshot> isolate_snapshot,
fml::RefPtr<const DartSnapshot> service_isolate_snapshot);
FML_DISALLOW_COPY_AND_ASSIGN(DartVMData);
};
} // namespace flutter
#endif // FLUTTER_RUNTIME_DART_VM_DATA_H_