开一个帖子,吐槽一下HarmonyOS鸿蒙Next官网的文档
开一个帖子,吐槽一下HarmonyOS鸿蒙Next官网的文档 进行鸿蒙相关的工作也有大半年了,在这短时间内,接触最多便是鸿蒙开发的官方文档。我最直观的感受就是ArkTs部分和C++部分的文档像是完全不同的两拨人来写的。如果说ArkTs部分的文档还有点缺点,那么C++的文档完全就是槽点遍布。
ArkTs部分的文档,虽说有些许错误和翻译不合适,反馈后也得到了及时的更正,另一个就是文档搭配的示例代码更新不及时,很多示例在经过几次迭代之后毕竟不能使用,或者相关的接口以及废弃,还有部分官推接口,在示例中用的还是老的,这里点名router和navigation。
C++部分的文档看的真叫我一个恼火。先说下,我只有一点点的C的基础,算是完全小白。看这个C++文档完全不知所云,部分参数的介绍也仅仅是翻译一下。拜托,我要的是翻译吗?还有C++的文档,前后割裂严重,我看文档不仅看Api接口还有紧接的示例,怎么用。文档呢,直接将两者分开,说明是说明,示例你得重新搜索,完全就违背了文档的用意。劝退非C开发者理由+1;比如:创建OH_DecodingOptions指针:
- Image_ErrorCode OH_DecodingOptions_Create (OH_DecodingOptions ** options)
文档中直接就是Api,这个OH_DecodingOptions **options是什么,怎么来的,没说
来看下Api说明:
不是,我是看不懂这个options是什么类型嘛?你好歹给个超链接啊。这样的例子还有很多。
不如都来吐槽下官网的文档,声音越大,说不定,就能改的越快
更多关于开一个帖子,吐槽一下HarmonyOS鸿蒙Next官网的文档的实战教程也可以访问 https://www.itying.com/category-93-b0.html
介绍了ios,介绍了Android,介绍了AGC,就是不告诉你怎么在鸿蒙中使用。主打一个不会就偷懒
更多关于开一个帖子,吐槽一下HarmonyOS鸿蒙Next官网的文档的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html
确实如此ArkTs官方文档中的示例代码接口,就有过期的老接口,拷贝过来后还需要读懂代码意图后,手更新到新的接口,截止到现在依然存在。
这个也确实哦@HarmonyOS Docs
找HarmonyOS工作还需要会Flutter的哦,有需要Flutter教程的可以学学大地老师的教程,很不错,B站免费学的哦:BV1S4411E7LY/?p=17
非常赞同,ndk部分是真的生涩难懂,还有openharmony gitee上的文档,一年前的都今年都不带更新的,开发起来是真费劲提工单,让去Gitee上提issue,我一个问题好几个月还没等到回复呢,诶
ArkTs部分的文档,虽说有些许错误和翻译不合适,反馈后也得到了及时的更正,另一个就是文档搭配的示例代码更新不及时,很多示例在经过几次迭代之后毕竟不能使用,或者相关的接口以及废弃,还有部分官推接口,在示例中用的还是老的,这里点名router和navigation。
这个问题是否可以发下文档链接?
当前官网文档示例代码,文档团队也通过一些自动化工具例行检测示例代码问题,主动识别修复。
针对开发者反馈的VOD,我们也在组织问题的及时确认修复更新官网。
当前针对router和navigation的示例代码排查已经完成,文档本周会更新上网~
开发者您好,
感谢您的意见反馈,关于NDK接口参考当前是通过接口头文件生成,头文件中无法承载示例代码等信息,相关内容通过开发指南来承载。建议您优先查看开发指南:
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/image-overview-V5?catalogVersion=V5
其他几个具体问题,我们组织相关团队确认后答复。
文档写的用户体验很差呢,参数什么的都很难找,不够简洁明了,可以多参考一下其他的一些框架文档
还有这个HmsInstanceid
详细的告诉开发者怎么在Ios,Android,鸿蒙Java中使用,那我现在怎么在ArkTs中使用呢?还是说ArkTs中有别的Api代替?你倒是在说明里说一声啊,主打一个不知道,我就不写,默认你晓得是吧
是否方便提供下文档链接?
谢谢~,
还有,这个,前面告诉我不用导入
编译会给你报错: 错误原因是什么?A ‘undefined symbol’ error has occurred.
怎么解决呢?给了一个连接: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/ide-hvigor-faqs-V5#section13911353105320
查看之后,缺少库文件,好,再去找库文件,代码里用了这个函数,找它的库文件是哪个,
HarmonyOS鸿蒙Next官网的文档存在以下问题:
-
结构不清晰:文档目录层级复杂,查找特定功能或API时需多次跳转,影响效率。
-
内容不完整:部分关键功能或接口缺乏详细说明,示例代码缺失或过于简单,难以直接应用。
-
更新滞后:文档内容与最新版本系统或开发工具不同步,导致开发者使用过时信息。
-
搜索功能差:搜索关键词时,结果不精准,常出现无关内容,难以快速定位所需信息。
-
语言表达晦涩:部分文档描述过于技术化,缺乏通俗解释,新手开发者理解困难。
-
缺乏实践指导:文档偏重理论,缺少实际开发场景的指导,难以解决具体问题。
-
多语言支持不足:部分文档仅提供中文版本,对非中文开发者不友好。
-
错误信息未及时修正:文档中存在技术错误或表述不准确,未及时更新或修正。
-
API文档不统一:不同模块的API文档风格不一致,部分模块缺少参数说明或返回值解释。
-
缺乏交互性:文档为静态页面,无法直接运行示例代码或进行实时调试。
HarmonyOS鸿蒙Next官网的文档确实让人有些头疼。首先,文档结构不够清晰,查找特定功能或API时常常需要花费大量时间。其次,部分内容更新不及时,导致开发者在实际操作中遇到问题。此外,示例代码不够丰富,尤其是复杂场景下的实现案例较少,增加了开发难度。希望官方能优化文档结构,提供更多实用示例,并确保内容的及时更新,以提升开发者体验。