#include <platform_isolate_manager.h>

Public Member Functions
bool	HasShutdown ()

bool	HasShutdownMaybeFalseNegative ()

bool	RegisterPlatformIsolate (Dart_Isolate isolate)

void	RemovePlatformIsolate (Dart_Isolate isolate)

void	ShutdownPlatformIsolates ()

bool	IsRegisteredForTestingOnly (Dart_Isolate isolate)

Detailed Description

Maintains a list of registered platform isolates, so that they can be proactively shutdown as a group during shell shutdown.

Definition at line 18 of file platform_isolate_manager.h.

Member Function Documentation

◆ HasShutdown()

bool flutter::PlatformIsolateManager::HasShutdown ( )

Returns whether the PlatformIsolateManager is shutdown. New isolates cannot be registered after the manager is shutdown. Must be called on the platform thread.

Definition at line 11 of file platform_isolate_manager.cc.

                                         {
  // TODO(flutter/flutter#136314): Assert that we're on the platform thread.
  std::scoped_lock lock(lock_);
  return is_shutdown_;
}

◆ HasShutdownMaybeFalseNegative()

bool flutter::PlatformIsolateManager::HasShutdownMaybeFalseNegative ( )

Returns whether the PlatformIsolateManager is shutdown. New isolates cannot be registered after the manager is shutdown. Callable from any thread. The result may be obsolete immediately after the call.

Definition at line 17 of file platform_isolate_manager.cc.

                                                           {
  std::scoped_lock lock(lock_);
  return is_shutdown_;
}

◆ IsRegisteredForTestingOnly()

bool flutter::PlatformIsolateManager::IsRegisteredForTestingOnly ( Dart_Isolate isolate )

Returns whether an isolate is registered. For testing only. Callable from any thread.

Definition at line 65 of file platform_isolate_manager.cc.

                                                                            {
  std::scoped_lock lock(lock_);
  return platform_isolates_.find(isolate) != platform_isolates_.end();
}

◆ RegisterPlatformIsolate()

bool flutter::PlatformIsolateManager::RegisterPlatformIsolate ( Dart_Isolate isolate )

Register an isolate in the list of platform isolates. Callable from any thread.

Definition at line 22 of file platform_isolate_manager.cc.

                                                                         {
  std::scoped_lock lock(lock_);
  if (is_shutdown_) {
    // It's possible shutdown occured while we were trying to aquire the lock.
    return false;
  }
  FML_DCHECK(platform_isolates_.find(isolate) == platform_isolates_.end());
  platform_isolates_.insert(isolate);
  return true;
}

◆ RemovePlatformIsolate()

void flutter::PlatformIsolateManager::RemovePlatformIsolate ( Dart_Isolate isolate )

Remove an isolate from the list of platform isolates. Must be called from the platform thread.

Definition at line 33 of file platform_isolate_manager.cc.

                                                                       {
  // This method is only called by DartIsolate::OnShutdownCallback() during
  // isolate shutdown. This can happen either during the ordinary platform
  // isolate shutdown, or during ShutdownPlatformIsolates(). In either case
  // we're on the platform thread.
  // TODO(flutter/flutter#136314): Assert that we're on the platform thread.
  // Need a method that works for ShutdownPlatformIsolates() too.
  std::scoped_lock lock(lock_);
  if (is_shutdown_) {
    // Removal during ShutdownPlatformIsolates. Ignore, to avoid modifying
    // platform_isolates_ during iteration.
    FML_DCHECK(platform_isolates_.empty());
    return;
  }
  FML_DCHECK(platform_isolates_.find(isolate) != platform_isolates_.end());
  platform_isolates_.erase(isolate);
}

◆ ShutdownPlatformIsolates()

void flutter::PlatformIsolateManager::ShutdownPlatformIsolates ( )

Shuts down all registered isolates, and the manager itself. Must be called from the platform thread.

Definition at line 51 of file platform_isolate_manager.cc.

                                                      {
  // TODO(flutter/flutter#136314): Assert that we're on the platform thread.
  // There's no current UIDartState here, so platform_isolate.cc's method won't
  // work.
  std::scoped_lock lock(lock_);
  is_shutdown_ = true;
  std::unordered_set<Dart_Isolate> platform_isolates;
  std::swap(platform_isolates_, platform_isolates);
  for (Dart_Isolate isolate : platform_isolates) {
    Dart_EnterIsolate(isolate);
    Dart_ShutdownIsolate();
  }
}

The documentation for this class was generated from the following files:

runtime/platform_isolate_manager.h
runtime/platform_isolate_manager.cc

Public Member Functions