Add native public API documentations

[pandamicro]

Currently there is no doc about how to use jsb APIs, they are absolutely needed for native development. The missing content include but not limited to

1. Application
2. FileUtils
3. PAL related APIs
4. Native Events
5. Network

@minggo please give a complete list and assign the tasks

Either we create manual docs which describes briefly all the APIs, or we generate all native APIs from JS Binding tools and make them available in API docs

[minggo]

Ok, i will check which module is needed and suitable to be public in v3.6.0 for native developers.

[minggo]

And should check if anything is available in ts, but missing documentation.

[minggo]

JSB related documentation:

• FileUtils(should check if some api missed) @qiuguohua
• jsb.copyTextToClipboard @qiuguohua
• jsb.zipUtils @mmyduckx
• jsb.garbageCollect @PatriceJiang
• reflection @timlyeee
• AssetsManager @PatriceJiang

Where and how to write the API doc @PPpro

[dumganhar]

JSB related documentation:

jsb.onError
jsb.garbageCollect
jsb.copyTextToClipboard
jsb.saveByteCode
jsb.zipUtils

[dumganhar]

Should EventDispatcher be public for native developers?

[minggo]

Should EventDispatcher be public for native developers?

If not, then how to listen some events in c++? Some application may do some operations based on these events in C++.

jsb.onError
jsb.copyTextToClipboard
jsb.saveByteCode

Does engine have these features?

[dumganhar]

If not, then how to listen some events in c++? Some application may do some operations based on these events in C++.

Why do developers need to write event registration code by C++ ? In general, he should do it in JS to subcribe touch, mouse, background, foreground ... events. I think EventDispatcher should be private now and it should be only used for dispatching events to JS or interactive with other internal modules.

Does engine have these features?

Yes, I found some code like :

void SystemWindow::copyTextToClipboard(const std::string &text) {
    NSPasteboard *pasteboard = [NSPasteboard generalPasteboard];
    [pasteboard clearContents];
    NSString *tmp = [NSString stringWithCString:text.c_str() encoding:NSUTF8StringEncoding];
    [pasteboard setString:tmp forType:NSPasteboardTypeString];
}

[minggo]

Why do developers need to write event registration code by C++ ? In general, he should do it in JS to subcribe touch, mouse, background, foreground ... events. I think EventDispatcher should be private now and it should be only used for dispatching events to JS or interactive with other internal modules.

It is ok not be public currently.

Yep, we should add docs for copyTextToClipboard .

[minggo]

@PPpro please describe where and how to write the API.

[PPpro]

docs added https://github.com/cocos/3d-tasks/blob/master/api-docs/native-binding-api.md
related PR #11478

[PPpro]

we also need to update the mannual docs @minggo

• https://docs.cocos.com/creator/manual/zh/advanced-topics/js-java-bridge.html?h=%E5%8F%8D%E5%B0%84 @timlyeee
• https://docs.cocos.com/creator/manual/zh/advanced-topics/js-oc-bridge.html @timlyeee
• https://docs.cocos.com/creator/manual/zh/advanced-topics/jsb-bridge-wrapper.html @timlyeee
• https://docs.cocos.com/creator/manual/zh/advanced-topics/hot-update-manager.html @PatriceJiang