Xcode имеет возможность проверять проблемы с комментариями документации и сообщать предупреждения, когда что-то не так. Например, я добавил Facebook SDK в свой проект, используя CocoaPods. В какой-то момент в файле FBError.h появится следующий код:
/*!
@typedef NS_ENUM (NSInteger, FBErrorCategory)
@abstract Indicates the Facebook SDK classification for the error
@discussion
*/
Обратите внимание, что параметр @discussion пуст, и Xcode соответственно генерирует предупреждение:
Пустой абзац передан команде "@discussion"
Однако, SDK для Facebook не является единственной библиотекой, которую я добавил в мой проект, а на вкладке "Проблемы" есть другие предупреждения, связанные с документацией, от сторонних файлов, от установленных мной Pods.
Я хотел бы знать, как подавить этот вид предупреждения для этих файлов.
Вы можете использовать этот фрагмент для подавления предупреждений:
#pragma clang diagnostic push
#pragma clang diagnostic ignored "-Wdocumentation"
#import <YourHeader.h>
#pragma clang diagnostic pop
см. эту проблему в cocoapod: https://github.com/CocoaPods/CocoaPods/issues/1481 (отрывок из этого фрагмента)
Как игнорировать предупреждение, поступающее из библиотеки, добавленной cocoapods?
В вашем podfile добавьте
inhibit_all_warnings!
удалить все предупреждения
или
pod 'Facebook-iOS-SDK', :inhibit_warnings => true
для удаления предупреждений из конкретной библиотеки.
Я сталкиваюсь с той же проблемой при использовании cocoapods.
Если вы используете cocoapods и хотите отключить предупреждения от файлов pods, вы можете сделать это:
Build Settings выберите All && & Levels, затем найдите documentation comments.documentation comments на NO, измените цель documentation comments на YES.Document issue от ваших файлов контейнеров и все еще иметь их для своих собственных файлов.documentation comments до NO, чтобы сделать трюк. 