使用@link和Xcode 6

Question

我正在使用HeaderDoc来记录我的代码，我想链接到文档中的其他方法。我不是想生成HTML（至少目前为止），但我确实希望它出现在Xcode的右侧面板中。以下是Xcode中出现的<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent" android:layout_height="match_parent" android:paddingLeft="64dp" android:paddingRight="64dp" android:paddingTop="@dimen/activity_vertical_margin" android:paddingBottom="@dimen/activity_vertical_margin" tools:context="com.example.sunshine.app.MainActivityFragment$PlaceholderFragment" android:id="@+id/container"> <ListView android:id="@+id/listview_forecast" android:layout_width="match_parent" android:layout_height="match_parent" /> </FrameLayout> 文档。我想实现那些引用我自己编写的其他方法的蓝色链接：

文档说要使用02-04 07:12:41.022 11478-11478/? E/libEGL﹕ call to OpenGL ES API with no current context (logged once per thread) 02-04 07:17:25.447 12449-12449/? E/Trace﹕ error opening trace file: No such file or directory (2) 02-04 07:17:27.697 12474-12474/? E/Trace﹕ error opening trace file: No such file or directory (2) 02-04 07:17:28.202 12492-12492/? E/Trace﹕ error opening trace file: No such file or directory (2) 02-04 07:17:28.313 12506-12506/? E/Trace﹕ error opening trace file: No such file or directory (2) 02-04 07:17:28.457 12524-12524/? E/Trace﹕ error opening trace file: No such file or directory (2) 02-04 07:17:28.706 12547-12547/? E/Trace﹕ error opening trace file: No such file or directory (2) 02-04 07:17:28.802 12547-12553/? E/jdwp﹕ Failed sending reply to debugger: Broken pipe 02-04 07:17:28.853 12547-12547/? E/AndroidRuntime﹕ FATAL EXCEPTION: main java.lang.RuntimeException: Unable to start activity ComponentInfo{com.example.android.sunshine.app/com.example.android.sunshine.app.MainActivity}: android.view.InflateException: Binary XML file line #2: Error inflating class fragment at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:2351) at android.app.ActivityThread.handleLaunchActivity(ActivityThread.java:2403) at android.app.ActivityThread.access$600(ActivityThread.java:165) at android.app.ActivityThread$H.handleMessage(ActivityThread.java:1373) at android.os.Handler.dispatchMessage(Handler.java:107) at android.os.Looper.loop(Looper.java:194) at android.app.ActivityThread.main(ActivityThread.java:5370) at java.lang.reflect.Method.invokeNative(Native Method) at java.lang.reflect.Method.invoke(Method.java:525) at com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:833) at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:600) at dalvik.system.NativeStart.main(Native Method) Caused by: android.view.InflateException: Binary XML file line #2: Error inflating class fragment at android.view.LayoutInflater.createViewFromTag(LayoutInflater.java:704) at android.view.LayoutInflater.inflate(LayoutInflater.java:466) at android.view.LayoutInflater.inflate(LayoutInflater.java:396) at android.view.LayoutInflater.inflate(LayoutInflater.java:352) at android.support.v7.app.AppCompatDelegateImplV7.setContentView(AppCompatDelegateImplV7.java:249) at android.support.v7.app.AppCompatActivity.setContentView(AppCompatActivity.java:106) at com.example.android.sunshine.app.MainActivity.onCreate(MainActivity.java:34) at android.app.Activity.performCreate(Activity.java:5122) at android.app.Instrumentation.callActivityOnCreate(Instrumentation.java:1146) at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:2315)             at android.app.ActivityThread.handleLaunchActivity(ActivityThread.java:2403)             at android.app.ActivityThread.access$600(ActivityThread.java:165)             at android.app.ActivityThread$H.handleMessage(ActivityThread.java:1373)             at android.os.Handler.dispatchMessage(Handler.java:107)             at android.os.Looper.loop(Looper.java:194)             at android.app.ActivityThread.main(ActivityThread.java:5370)             at java.lang.reflect.Method.invokeNative(Native Method)             at java.lang.reflect.Method.invoke(Method.java:525)             at com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:833)             at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:600)             at dalvik.system.NativeStart.main(Native Method) Caused by: java.lang.ClassCastException: com.example.android.sunshine.app.MainActivity cannot be cast to android.app.Fragment at android.app.Fragment.instantiate(Fragment.java:585) at android.app.Fragment.instantiate(Fragment.java:560) at android.app.Activity.onCreateView(Activity.java:4727) at android.support.v7.app.AppCompatDelegateImplV11.callActivityOnCreateView(AppCompatDelegateImplV11.java:41) at android.support.v7.app.AppCompatDelegateImplV7.onCreateView(AppCompatDelegateImplV7.java:826) at android.support.v4.view.LayoutInflaterCompatHC$FactoryWrapperHC.onCreateView(LayoutInflaterCompatHC.java:44) at android.view.LayoutInflater.createViewFromTag(LayoutInflater.java:675)             at android.view.LayoutInflater.inflate(LayoutInflater.java:466)             at android.view.LayoutInflater.inflate(LayoutInflater.java:396)             at android.view.LayoutInflater.inflate(LayoutInflater.java:352)             at android.support.v7.app.AppCompatDelegateImplV7.setContentView(AppCompatDelegateImplV7.java:249)             at android.support.v7.app.AppCompatActivity.setContentView(AppCompatActivity.java:106)             at com.example.android.sunshine.app.MainActivity.onCreate(MainActivity.java:34)             at android.app.Activity.performCreate(Activity.java:5122)             at android.app.Instrumentation.callActivityOnCreate(Instrumentation.java:1146)             at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:2315)             at android.app.ActivityThread.handleLaunchActivity(ActivityThread.java:2403)             at android.app.ActivityThread.access$600(ActivityThread.java:165)             at android.app.ActivityThread$H.handleMessage(ActivityThread.java:1373)             at android.os.Handler.dispatchMessage(Handler.java:107)             at android.os.Looper.loop(Looper.java:194)             at android.app.ActivityThread.main(ActivityThread.java:5370)             at java.lang.reflect.Method.invokeNative(Native Method)             at java.lang.reflect.Method.invoke(Method.java:525)             at com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:833)             at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:600)             at dalvik.system.NativeStart.main(Native Method) 02-04 07:17:29.027 12563-12563/? E/Trace﹕ error opening trace file: No such file or directory (2) 02-04 07:17:29.361 12580-12580/? E/Trace﹕ error opening trace file: No such file or directory (2) 02-04 07:17:29.550 12599-12599/? E/Trace﹕ error opening trace file: No such file or directory (2) 02-04 07:17:29.609 12612-12612/? E/Trace﹕ error opening trace file: No such file or directory (2) 02-04 07:17:32.472 12639-12639/? E/Trace﹕ error opening trace file: No such file or directory (2) 02-04 07:17:34.982 493-511/? E/KeyguardUpdateMonitor﹕ Object tried to add another callback java.lang.Exception: Called by at com.android.internal.policy.impl.keyguard.KeyguardUpdateMonitor.registerCallback(KeyguardUpdateMonitor.java:1108) at com.android.internal.policy.impl.keyguard.KeyguardSelectorView.onResume(KeyguardSelectorView.java:331) at com.android.internal.policy.impl.keyguard.KeyguardHostView.onScreenTurnedOn(KeyguardHostView.java:1118) at com.android.internal.policy.impl.keyguard.KeyguardViewManager.onScreenTurnedOn(KeyguardViewManager.java:403) at com.android.internal.policy.impl.keyguard.KeyguardViewMediator.handleNotifyScreenOn(KeyguardViewMediator.java:1813) at com.android.internal.policy.impl.keyguard.KeyguardViewMediator.access$2400(KeyguardViewMediator.java:106) at com.android.internal.policy.impl.keyguard.KeyguardViewMediator$4.handleMessage(KeyguardViewMediator.java:1449) at android.os.Handler.dispatchMessage(Handler.java:107) at android.os.Looper.loop(Looper.java:194) at android.os.HandlerThread.run(HandlerThread.java:60) 02-04 07:17:35.083 120-1870/? E/AudioMTKHardware﹕ setCommonParameters() still have param.size() = 1, remain param = "screen_state=on" 02-04 07:17:41.110 12672-12672/com.example.android.sunshine.app E/Trace﹕ error opening trace file: No such file or directory (2) 02-04 07:17:41.247 12672-12672/com.example.android.sunshine.app E/AndroidRuntime﹕ FATAL EXCEPTION: main java.lang.RuntimeException: Unable to start activity ComponentInfo{com.example.android.sunshine.app/com.example.android.sunshine.app.MainActivity}: android.view.InflateException: Binary XML file line #2: Error inflating class fragment at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:2351) at android.app.ActivityThread.handleLaunchActivity(ActivityThread.java:2403) at android.app.ActivityThread.access$600(ActivityThread.java:165) at android.app.ActivityThread$H.handleMessage(ActivityThread.java:1373) at android.os.Handler.dispatchMessage(Handler.java:107) at android.os.Looper.loop(Looper.java:194) at android.app.ActivityThread.main(ActivityThread.java:5370) at java.lang.reflect.Method.invokeNative(Native Method) at java.lang.reflect.Method.invoke(Method.java:525) at com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:833) at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:600) at dalvik.system.NativeStart.main(Native Method) Caused by: android.view.InflateException: Binary XML file line #2: Error inflating class fragment at android.view.LayoutInflater.createViewFromTag(LayoutInflater.java:704) at android.view.LayoutInflater.inflate(LayoutInflater.java:466) at android.view.LayoutInflater.inflate(LayoutInflater.java:396) at android.view.LayoutInflater.inflate(LayoutInflater.java:352) at android.support.v7.app.AppCompatDelegateImplV7.setContentView(AppCompatDelegateImplV7.java:249) at android.support.v7.app.AppCompatActivity.setContentView(AppCompatActivity.java:106) at com.example.android.sunshine.app.MainActivity.onCreate(MainActivity.java:34) at android.app.Activity.performCreate(Activity.java:5122) at android.app.Instrumentation.callActivityOnCreate(Instrumentation.java:1146) at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:2315)             at android.app.ActivityThread.handleLaunchActivity(ActivityThread.java:2403)             at android.app.ActivityThread.access$600(ActivityThread.java:165)             at android.app.ActivityThread$H.handleMessage(ActivityThread.java:1373)             at android.os.Handler.dispatchMessage(Handler.java:107)             at android.os.Looper.loop(Looper.java:194)             at android.app.ActivityThread.main(ActivityThread.java:5370)             at java.lang.reflect.Method.invokeNative(Native Method)             at java.lang.reflect.Method.invoke(Method.java:525)             at com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:833)             at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:600)             at dalvik.system.NativeStart.main(Native Method) Caused by: java.lang.ClassCastException: com.example.android.sunshine.app.MainActivity cannot be cast to android.app.Fragment at android.app.Fragment.instantiate(Fragment.java:585) at android.app.Fragment.instantiate(Fragment.java:560) at android.app.Activity.onCreateView(Activity.java:4727) at android.support.v7.app.AppCompatDelegateImplV11.callActivityOnCreateView(AppCompatDelegateImplV11.java:41) at android.support.v7.app.AppCompatDelegateImplV7.onCreateView(AppCompatDelegateImplV7.java:826) at android.support.v4.view.LayoutInflaterCompatHC$FactoryWrapperHC.onCreateView(LayoutInflaterCompatHC.java:44) at android.view.LayoutInflater.createViewFromTag(LayoutInflater.java:675)             at android.view.LayoutInflater.inflate(LayoutInflater.java:466)             at android.view.LayoutInflater.inflate(LayoutInflater.java:396)             at android.view.LayoutInflater.inflate(LayoutInflater.java:352)             at android.support.v7.app.AppCompatDelegateImplV7.setContentView(AppCompatDelegateImplV7.java:249)             at android.support.v7.app.AppCompatActivity.setContentView(AppCompatActivity.java:106)             at com.example.android.sunshine.app.MainActivity.onCreate(MainActivity.java:34)             at android.app.Activity.performCreate(Activity.java:5122)             at android.app.Instrumentation.callActivityOnCreate(Instrumentation.java:1146)             at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:2315)             at android.app.ActivityThread.handleLaunchActivity(ActivityThread.java:2403)             at android.app.ActivityThread.access$600(ActivityThread.java:165)             at android.app.ActivityThread$H.handleMessage(ActivityThread.java:1373)             at android.os.Handler.dispatchMessage(Handler.java:107)             at android.os.Looper.loop(Looper.java:194)             at android.app.ActivityThread.main(ActivityThread.java:5370)             at java.lang.reflect.Method.invokeNative(Native Method)             at java.lang.reflect.Method.invoke(Method.java:525)             at com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:833)             at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:600)             at dalvik.system.NativeStart.main(Native Method) 02-04 07:17:41.285 493-513/? E/AppErrorDialog﹕ Failed to get ILowStorageHandle instance 02-04 07:17:45.682 120-438/? E/﹕ AudioCloseDumpPCMFile file== NULL 02-04 07:17:45.682 120-438/? E/﹕ AudioCloseDumpPCMFile file== NULL 02-04 07:17:50.354 645-645/? E/wpa_supplicant﹕ Sorted scan results 02-04 07:17:50.354 645-645/? E/wpa_supplicant﹕ f4:3e:61:92:4b:21 freq=2462 qual=0 noise=0 level=-83 flags=0xb 02-04 07:17:50.354 645-645/? E/wpa_supplicant﹕ IEs 02-04 07:17:50.354 645-645/? E/wpa_supplicant﹕ ，但它似乎不起作用：

这是我试过的：

-applicationDidEnterBackground:

结果如下：

正如您所看到的那样，它无法正常渲染。我读here @link已被破坏，但评论可以追溯到2013年。有没有修复？我做错了吗？

编辑：我尝试了Santa的建议，结果就是这样：

/**
 *  @abstract   Returns an array with a copy of all elements in the heap in sorted order.
 *
 *  @discussion The original heap remains unchanged. This getter uses Heap Sort which takes O(n log n),
 *              although it copies the heap first (in linear time). If losing the elements on the heap is
 *              acceptable you should use @link -removeAllObjectsWithArray: @/link instead, which is faster.
 */

呈现为：