Add Flutter Support, covering all of the native platforms.

Platforms -

• [x] Android
• [x] Linux
• [x] Windows

MacOS & iOS will be done separately.

This PR only takes care of 64bit systems. For 32 bit systems, issue #20 should be tracked.

Reference #5

Benchmarks

Package Version: 0.0.1+1 Cronet Version: 86.0.4240.198 Cronet Build Type: Debug Wrapper Version: 1 Dart SDK Version: 2.12.0

• [x] Latency
  • [x] Writing Benchmarking Code
  • [x] Gathering observations in different environments and writing reports
  • [x] Comparing with dart:io
• [x] Throughput
  • [x] Writing Benchmarking Code
  • [x] Gathering observations in different environments and writing reports
  • [x] Comparing with dart:io

May get affected by #11

Closes #3

We should get an understanding of how package:cronet stacks up against dart:io. Cronet is not integrated into the Dart VM which might create some overhead. On the other hand Cronet provides HTTP 2 and QUIC.

We should add a benchmarks/ folder. Some inspiration from setting up benchmarks can be done from https://github.com/dart-lang/sdk/blob/master/benchmarks/MapLookup/dart/MapLookup.dart.

We are interested in multiple dimensions:

• JIT (dart ...) and AOT (dart compile exe ...).
• Latency (how fast can a single request be) and throughput (how many concurrent requests per second can we do) - tested by doing only sequential requests and parallel requests respectively.

Summary

1. HttpClient with QUIC, HTTP2, brotli support
2. HttpClient with a customizable user agent string
3. HttpClient close method (without force close)
4. open, openUrl & other associated methods.
5. Response is consumable using dart:io style API.
6. Different types of Exceptions are implemented.

Notes and Breaking Changes from dart:io

1. Custom SecurityContext is no longer handled by the client. Users have to handle it in other ways. (To be documented later)

2. userAgent property is now read-only. Custom userAgent should be passed as a constructor argument.

3. Force close isn't enabled in this PR.

Partial migration from: unsuitable001/dart_cronet_sample

Spawn a new request when any request is returned within stipulated time duration in case of throughput benchmark to maintain the number of parallel requests performed.

Closes #16

Continuation #8

• Bumped up the version of every dependency package as much as possible.
• Use package:args for CLI argument parsing.
  • • [x] bin/setup.dart
  • • [x] tool/ files. (Tools don't take any CLI arg)
  • • [x] benchmark/ files.
• Fixes wrong location issue in run_all.dart due to the migration from benchmarks/ to benchmark/ (#14 )
• Fixed wrong cli suggestion in case of un-locateable dylib.
• Fixes RangeError (index) in benchmark/throughput.dart in case of 0 result.
• Added README.md to example folder to fetch more pub points.

Closes #12

We shouldn't return pointers that we received as a callback parameter from cronet. In a slower system or while doing bunch of requests togather (e.g. benchmarking), we can accidentally dereference those cronet created pointers after cronet frees them.

UTF8 decoding the newLocation URL string which is received as a callback of onRedirect event causes the following error:

Unhandled exception:
FormatException: Unexpected extension byte (at offset .....

This PR fixes this issue by dereferencing and getting the raw data from cronet created pointers in the wrapper then sending copied data to the dart side via nativeport.

Also patched crash on parallel request if 404 is received.

NOTE: Update Binaries.

Use an array of uint64 to store the memory addresses of arguments (of cronet callbacks). On 32 bit systems, we must store the memory address on the lower 32 bits of uint64 and upper 32 bits should be padded by 0.

Closes #20

Adding support for user added headers while performing a request. Most common use case for this feature is setting content-type header while sending some data through POST request.

Add force close (optional) parameter to HttpClient.close() method along with tests for it.

Original API reference: https://api.dart.dev/stable/2.13.1/dart-io/HttpClient/close.html

Currently only 64bit systems (Android and Desktops) are compatible with this package. Support for 32 bit systems are required for older devices and Android Emulators.

flutter pub run cronet:setup failed with error

Unhandled exception: Invalid argument(s): Failed to lookup symbol 'VersionString': error code 127 #0 DynamicLibrary.lookup (dart:ffi-patch/ffi_dynamic_library_patch.dart:34:70) #1 Wrapper._VersionString_ptr (package:cronet/src/wrapper/generated_bindings.dart:34:52) #2 Wrapper._VersionString_ptr (package:cronet/src/wrapper/generated_bindings.dart) #3 Wrapper._VersionString (package:cronet/src/wrapper/generated_bindings.dart:36:7) #4 Wrapper._VersionString (package:cronet/src/wrapper/generated_bindings.dart) #5 Wrapper.VersionString (package:cronet/src/wrapper/generated_bindings.dart:30:12) #6 downloadCronetBinaries (file:///C:/flutter/.pub-cache/hosted/pub.dartlang.org/cronet-0.0.7/bin/setup.dart:99:32) #7 main (file:///C:/flutter/.pub-cache/hosted/pub.dartlang.org/cronet-0.0.7/bin/setup.dart:280:13) #8 _delayEntrypointInvocation. (dart:isolate-patch/isolate_patch.dart:295:32) #9 _RawReceivePortImpl._handleMessage (dart:isolate-patch/isolate_patch.dart:192:12) pub finished with exit code 255

[√] Flutter (Channel stable, 3.3.9, on Microsoft Windows [Version 10.0.22621.900], locale ja-JP) • Flutter version 3.3.9 on channel stable at C:\flutter • Upstream repository https://github.com/flutter/flutter.git • Framework revision b8f7f1f986 (3 weeks ago), 2022-11-23 06:43:51 +0900 • Engine revision 8f2221fbef • Dart version 2.18.5 • DevTools version 2.15.0

This issue was automatically created by Allstar.

Security Policy Violation Project is out of compliance with Binary Artifacts policy: binaries present in source code

Rule Description Binary Artifacts are an increased security risk in your repository. Binary artifacts cannot be reviewed, allowing the introduction of possibly obsolete or maliciously subverted executables. For more information see the Security Scorecards Documentation for Binary Artifacts.

Remediation Steps To remediate, remove the generated executable artifacts from the repository.

Artifacts Found

• ios/lib/libwrapper.a

Additional Information This policy is drawn from Security Scorecards, which is a tool that scores a project's adherence to security best practices. You may wish to run a Scorecards scan directly on this repository for more details.

Allstar has been installed on all Google managed GitHub orgs. Policies are gradually being rolled out and enforced by the GOSST and OSPO teams. Learn more at http://go/allstar

This issue will auto resolve when the policy is in compliance.

Issue created by Allstar. See https://github.com/ossf/allstar/ for more information. For questions specific to the repository, please contact the owner or maintainer.

Hi, thank you for this library!

I was wondering if support for the Webtransport protocol is planned. It seems Webtransport is supported by Cronet (as its js APIs are available in Chromium/Chrome since version 97).

Support for the Webtransport protocol would be huge in enabling Flutter developers to develop faster real-time apps and games.

Upgrade with ffi 2.0.1 and ffigen 6.0.1.

But need upgrade:

• cronet to actual version
• upload new release files (libs: libcronet and libwrapper)
• edit ./lib/src/constants.dart to new tag, cronetVersion, wrapperVersion

i have clone this repo and following instruction on readme,

and when I running the example app I have some issue like this

so I try to comment that line, it is worked, and I have not issue if I running on debug mode, but if I run flutter run --release or flutter build apk application always force close on emulator or real device

if i miss something, can you tell me please?