Doc for generation with multiple blocks of Api

[dbsxdbsx]

what's new

Mention the new example in Section 3.Features.
Add a new doc for detailed explanation on why and how to generate Api within multiple blocks(files).

related pr

#516
#527

related issue

#511

[fzyzcjy]

@all-contributors please add @dbsxdbsx for doc

[allcontributors]

@fzyzcjy

I've put up a pull request to add @dbsxdbsx! 🎉

[fzyzcjy]

Good work! LGTM, except some phrasing, which I will modify after merging.

[fzyzcjy]

Btw, https://app.grammarly.com is quite helpful to check and improve grammar automatically.

[fzyzcjy]

/cc @Desdaemon who wrote that wonderful tutorial part

[dbsxdbsx]

Good work! LGTM, except some phrasing, which I will modify after merging.

By the way, I forgot how flutter_rust_bridge solves the explicit and implicit APIs respectively.

[fzyzcjy]

what is explicit and implicit api?

[dbsxdbsx]

what is explicit and implicit api?

If API is defined by users, it is explicit, others like new_uint8_list are implicit API. Frb would throw panic with conflict on explicit API, but no warning but automatically add suffix starting from 0 to avoid implicit API conflict.

[fzyzcjy]

Ah, those are in the code details and I also do not remember very clearly currently.

I guess it is by simple string manipulation without fancy data structures.

Feel free to refactor them and PR!

[Desdaemon]

Great writeup @dbsxdbsx. I'm thinking whether it would be fruitful to pursue a crate-wide, explicit declaration process a la wasm_bindgen, which could solve a lot of the problems described here.

[dbsxdbsx]

Great writeup @dbsxdbsx. I'm thinking whether it would be fruitful to pursue a crate-wide, explicit declaration process a la wasm_bindgen, which could solve a lot of the problems described here.

I have no idea what "a crate-wide, explicit declaration process" means here. But I guess it is something related to support for the web platform, right?

[fzyzcjy]

I am not sure, I guess it may be another toml configuration file specifying things instead of using command-line?