mingweili0x
V2EX  ›  Apple

没人觉得 Apple 的技术文档一点都不友好吗?

  •  
  •   mingweili0x · Nov 15, 2017 · 5672 views
    This topic created in 3291 days ago, the information mentioned may be changed or developed.

    我之前开发过 Android 的应用。感觉 Google 给提供的文档,指导等对新用户非常友好。从第一步的下载 sdk,指定各种 runtime,到 hello world,到最基本的概念,新手应该知道的技术,全程下一步,下一步就好了。

    后来好奇,想看看比 Android “高端”不少的 iOS 开发是什么样的。但我进了官网之后就傻眼了,不知道从哪开始,各种技术之间是平行罗列的,没有说新手的 hello world 放在最前面,最基本的库的讲解,语言的选择,适配的概念放在后边,然后稍微进阶,讲解各种可能会用到的东西。

    如果说得不清楚的话,我找了几个链接,大家对比一下。(也许有可能我还真没找到 iOS 到底怎么在官网学)

    Android 就很清晰,从官网也非常容易找到,网址看着都这么友好: https://developer.android.com/training/index.html

    iOS,找到了相关的几个: https://developer.apple.com/library/content/referencelibrary/GettingStarted/DevelopiOSAppsSwift/Resources.html#//apple_ref/doc/uid/TP40015214-CH15-SW1,这个是从 google 直接点过来的,不是从官网找出来的)

    https://developer.apple.com/documentation/ 这个简直是噩梦了,iOS,macOS,各种奇怪的技术栈就那么一列,你让新手怎么找???再者,点进去之后更是噩梦了。随便来一个: https://developer.apple.com/documentation/gamekit,就是简单的类罗列,哪个技术的文档能这么写?哪个能这么写?? Apple 写文档的人就这么懒?你让别人一点主次都分不清, 上下文也没有,怎么学???

    大家没有这种感觉吗?

    没错,反正我对 Apple 的东西就有一种偏见,总感觉它们给人一种清高,爱咋地咋地,你们用户爱用不用,你们开发者爱学不学的态度。

    33 replies  •  2017-11-16 12:34:06 +08:00
    jasonchen168
    jasonchen168
    Nov 15, 2017
    1
    Xcode 不好用吗?直接上手写就好了
    dangyuluo
    dangyuluo
    Nov 15, 2017
    2
    高冷
    tscat
    tscat
    Nov 15, 2017 via Android
    3
    是这样。
    不过可能因为我有 java 基础先入为主的观念,我觉得安卓简单好多。ios 的体系架构特别不清晰
    unneeded
    unneeded
    Nov 15, 2017 via iPad
    4
    Android 这是 入门指南 吧,Apple 好像没这个东西,他可能认为入门的话玩玩 playground 就够了
    kx5d62Jn1J9MjoXP
    kx5d62Jn1J9MjoXP
    Nov 15, 2017
    5
    觉得 Android 文档不友好, 很多概念和 api 都没有解释清楚
    mingweili0x
    mingweili0x
    OP
    Nov 15, 2017
    6
    @ssynhtn @zhaidoudou123 #5 我说的就是指入门指南啊
    unneeded
    unneeded
    Nov 15, 2017 via iPad
    7
    @mingweili0x 我的意思是 Apple 可能认为文档就是文档,查 API 用的,入门之类的自己找教程,再基础的入门就用 playground
    shanjinwei
    shanjinwei
    Nov 15, 2017 via Android
    8
    关键安卓可以看源码 @ssynhtn
    kx5d62Jn1J9MjoXP
    kx5d62Jn1J9MjoXP
    Nov 15, 2017
    9
    @shanjinwei 幸好可以看源码, 不过源码不是你想看就看的, 既看不过来, 也不能全都看懂
    cubesugar
    cubesugar
    Nov 15, 2017
    10
    你是说类似这样的 https://developer.apple.com/library/content/referencelibrary/GettingStarted/DevelopiOSAppsSwift/

    另外还有各种视频教程,如白胡子老师,开源 demo
    mingweili0x
    mingweili0x
    OP
    Nov 15, 2017
    11
    @cubesugar 但是这只是无数 guide 里边的一篇,如果去它的主页: https://developer.apple.com/library/content/navigation/ 仍然感觉很杂
    mingweili0x
    mingweili0x
    OP
    Nov 15, 2017
    12
    @zhaidoudou123 哈哈,刚 google 一下 playground 是什么,笑死我了。那是给小学生用的拌方块的啊。
    mcluyu
    mcluyu
    Nov 15, 2017
    13
    @mingweili0x 并不是哦,对于学习语法,了解编程、面向对象等基础来说,是一种非常简便的方法,你搜到的只是一部分
    mingweili0x
    mingweili0x
    OP
    Nov 15, 2017
    14
    @mcluyu 谢谢你的热心哈。但咱们讨论的是 Android 和 Apple 开发的东西,不是 swift,Java 的编程语言呀
    EmbraceZ
    EmbraceZ
    Nov 15, 2017 via Android
    15
    mingweili0x
    mingweili0x
    OP
    Nov 15, 2017
    16
    @EmbraceZ 很不错啊,组织的很清楚。MSDN 不是号称最好的文档吗?之前用.NET 的时候没少查他们的文档
    webfrogs
    webfrogs
    Nov 15, 2017❤️1
    17
    开发环境搭建,macOS 反倒是最简单的,下载 Xcode 安装就全部搞定了。

    如果是入门,去 https://www.raywenderlich.com 里找教程,或者斯坦福老爷子的公开课,都是不错的选择。官网的文档确实不适合用来入门。

    官方文档还是适合有一定经验想要具体了解某个 framework 的开发者。

    还有楼主你说的那个 playground 是指 Swift Playground 这个 iPad app, @zhaidoudou123 指的是使用 Xcode 创建的 playground 环境。
    mingweili0x
    mingweili0x
    OP
    Nov 15, 2017
    18
    @ssynhtn 我也没深入过 android,但我从只有 Java 知识,从零开始,顺着官网上给的教程,最后弄出来一个完整的应用, 当研究生毕业设计
    mingweili0x
    mingweili0x
    OP
    Nov 15, 2017
    19
    @webfrogs 哦,了解,没实际做过 iOS 应用,不好意思
    chairuosen
    chairuosen
    Nov 15, 2017
    20
    有两种文档,一种是写的时候让你查的,一种是一步一步带你走的。
    zieglar
    zieglar
    Nov 15, 2017
    21
    可能楼主没有看过国内大部分公司的文档,比如某牛、某信、某云
    QAPTEAWH
    QAPTEAWH
    Nov 15, 2017❤️1
    22
    我记得王垠吐槽过 Apple 的文档,顺便赞过微软的。

    另外有些东西文档里没有,得去 WWDC 视频里找.....
    icyalala
    icyalala
    Nov 15, 2017
    23
    来个对比...
    Google:

    Apple:
    CastleBUPT
    CastleBUPT
    Nov 15, 2017
    24
    是的,没错,而且苹果的文档特别不清晰,用词文绉绉的,不像给开发者看的
    camillo
    camillo
    Nov 15, 2017
    25
    最后一句我来反一下 开发者不清楚 对用户以及配件商的文档 /支持倒是非常详尽的 而且更新很及时
    canxden
    canxden
    Nov 15, 2017
    26
    开发 ios 不都是跳到.h 文件里面看每个方法的注释的吗.......这个本来就是接口的文档, 又不是怎么实现这个功能的文档, 把这个接口的功能告诉给开发者就好了啊. 而且很多.h 文件里面的注释都有很多细节上的提示.
    真的需要说从入门那种构建项目, 不应该去查开发者的文档, 而是去查如何成为开发者的文档吧...
    kx5d62Jn1J9MjoXP
    kx5d62Jn1J9MjoXP
    Nov 15, 2017
    27
    @icyalala 这两个 drawRect 貌似意思是不一样的, 安卓的就是画一个长方形, 苹果的似乎是在给定的 rect 区域内画整个 view 的内容. 苹果的画长方形的方法似乎是 CGContextStrokeRect
    icyalala
    icyalala
    Nov 15, 2017
    28
    @ssynhtn 错了。。安卓是这个:
    nine99
    nine99
    Nov 15, 2017
    29
    我写的
    hstdt
    hstdt
    Nov 15, 2017 via iPhone
    30
    苹果入门文档应该这么找吧。先在官网索关键字,比如 tableview,然后会给你一些相关文档以及 demo 工程。然后你自己去看代码,一点点跟着敲去学习 tableview。如果只是想要跑起来程序,那么用模板新建一个就行了。
    mingweili0x
    mingweili0x
    OP
    Nov 16, 2017
    31
    @icyalala 我觉得这正好体现了 Apple 的人没法把 API 的介绍结构化,逻辑化,只能是一片长篇大论,真正的程序员是干不出这种事来的
    virgil1988
    virgil1988
    Nov 16, 2017
    32
    文档其实还不错,你用用 Xcode 半个月就疯了,我一直开发 iOS,被强制扔到 android,用了 AS 半个月后每次开 Xcode 内心都是拒绝的
    icyalala
    icyalala
    Nov 16, 2017 via iPhone
    33
    @mingweili0x 结构化的文档、综述这种也是有的,各种 Guide 里面就是。

    安卓文档不清或者需要了解细节的话,最起码有源码能看。iOS 就不行了啊,文档和 API 描述再不完善一些,那真没办法搞了。
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Privacy   ·   Solana   ·   948 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 57ms · UTC 19:49 · PVG 03:49 · LAX 11:49 · JFK 14:49
    ♥ Do have faith in what you're doing.