Deprecate the profilerOutputDir profiler and name Java members in V8/DevTools profiles

Offen
#2,100 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Maintainer antworten meist innerhalb von 1 Tag

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit
5/5
Geschätzter Aufwand
Über eine Woche
Anfängerfreundlichkeit
35/100
Issue-Typ
Feature
Klarheit
Größtenteils klar
Aktivitätsstatus
Aktiv
Tech-Stack
android, cpp
Bereich
mobile, performance

Rechercherichtung

Start by reading Profiler.cpp, MetadataNode::Wrap, and the core and CLI declarations for profilerOutputDir; the issue also points to @nativescript/core/profiling and the follow-up to #2099. Compare DevTools profiles for the listed Java constructors, methods, fields, and functions created by extend or interface implementations, then review V8's naming APIs. Done means the legacy profiler's deprecation or removal path is resolved and Java members have useful profile names; the issue leaves API compatibility decisions open.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

improvement

Is your feature request related to a problem? Please describe.

The runtime ships a legacy profiler, added in 2016 (d81045c76), next to the Chrome DevTools profiler:

  • Profiler.cpp always installs three globals:
    • __startCPUProfiler(name) and __stopCPUProfiler(name) wrap V8's CpuProfiler, and stopping writes <profilerOutputDir>/<app>-<name>-<time>.cpuprofile.
    • __heapSnapshot() writes a .heapsnapshot file to the same directory.
  • Setting android.profilerOutputDir also turns on MetadataNode::Wrap. That compiles a named JS wrapper around every Java class constructor and every Java method (function getAlpha() { return getAlpha.__func.apply(this, arguments); }) so that profiles show Java member names. The wrappers add a JS frame to every call and replace the functions apps see. In that mode a wrapper's prototype.constructor is the inner function, not the class the app sees.

As far as I can tell nobody uses it:

  • nothing in core, the CLI, the plugins or angular sets profilerOutputDir;
  • with the default empty value, Write builds a path at / and fails, so the globals produce nothing unless the option is set.

The only consumers I found are @nativescript/core/profiling's startCPUProfile/stopCPUProfile, which call these globals on Android, and the profilerOutputDir entries in core's config.interface.ts and the CLI's project.d.ts.

The DevTools CPU and heap profilers cover the same ground through the inspector, with a better workflow. The one thing the legacy profiler does that they don't is to start and stop from app code with no inspector attached.

Describe the solution you'd like

  1. Deprecate the legacy profiler.

    • Log a deprecation warning when profilerOutputDir is set.
    • Remove MetadataNode::Wrap and s_profilerEnabled in the next major release.
    • Decide what happens to __startCPUProfiler/__stopCPUProfiler/__heapSnapshot, and to core's startCPUProfile/stopCPUProfile:
      • remove them along with the profiler;
      • or keep them as thin helpers that write to the app's files directory by default, for profiling a release build without an inspector.
    • Deprecate profilerOutputDir in core's config types and the CLI's typings at the same time.
  2. Make V8/DevTools profiles more informative instead. Java members should show up under useful names in a DevTools CPU profile without wrapper functions. Start by checking what a profile shows today for:

    • Java class constructors (FunctionTemplate::SetClassName is already set to the dotted Java name);
    • instance and static methods (prototype template functions);
    • field accessors and static members;
    • functions created by extend and interface implementations.

    Then fill the gaps with V8's naming APIs: FunctionTemplate::SetClassName, Function::SetName, or naming the template functions after their property keys. Where a name alone is ambiguous across overloads or same-named methods of different classes, include the declaring class, e.g. android.view.View.getAlpha.

    • Optionally, label the time spent in the JS↔Java bridge: callback dispatch from Java, argument conversion and ObjectManager wrapper creation. A DevTools profile could then tell bridge overhead apart from app JS. V8's CPU profiler supports embedder states and trace events that could carry this.

Describe alternatives you've considered

  • Keep the profiler as is. It costs little at runtime when off: Wrap returns the function unchanged unless profilerOutputDir is set. But it is unmaintained, undocumented, and has semantic quirks when on.
  • Keep only the wrapper naming. It changes the functions apps see and adds a frame per call, so it distorts the very profiles it is meant to label.

Additional context

This came up while optimizing JS wrapper creation for Java objects, in the follow-up to #2099. Dropping a wrapper's own constructor property only made a difference in this profiler mode, where wrapper.constructor now resolves to the inner, unwrapped constructor, as new-created instances already did.

Vorherrschende Sprache
C++
Sterne
565
Forks
147
Ø Merge
1 T. 2 Std.
Gemergte PRs (30 T.)
27

Entwicklungsumgebung

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus NativeScript/android

Alle Issues in NativeScript/android

Ähnliche Issues

Weitere Issues zu C++

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.