title: WDGApp

WDGApp 是野狗各个功能模块的入口。用于初始化时的必要参数配置。 一个 WDGApp 实例对应一个野狗应用，在 SDK 内以应用名字区分。

属性

name

定义

Swift
```swift var name: String { get }

  1. <div class="objectivec-lan">Objective-C</div>```objectivec
  2. @property (readonly, copy, nonatomic) NSString *name;
说明

获取这个 WDGApp 实例的名字。


options

定义

Swift
```swift var options: WDGOptions { get }

  1. <div class="objectivec-lan">Objective-C</div>```objectivec
  2. @property (readonly, nonatomic) WDGOptions *options;
说明

初始化 SDK 的配置参数。


方法

+ configureWithOptions:

定义

Swift
```swift class func configure(with options: WDGOptions)

  1. <div class="objectivec-lan">Objective-C</div>```objectivec
  2. + (void)configureWithOptions:(WDGOptions *)options;
说明

初始化默认的 Wilddog app。默认的 app 名字是 __WDGAPP_DEFAULT。如果配置失败，会抛出异常。 这个方法是线程安全的。

参数
参数名 说明
options 配置 Wilddog 应用所需的 WDGOptions 实例。


+ configureWithName:options:

定义

Swift
```swift class func configure(withName name: String, options: WDGOptions)

  1. <div class="objectivec-lan">Objective-C</div>```objectivec
  2. + (void)configureWithName:(NSString *)name options:(WDGOptions *)options;
说明

用 options 和 name 配置一个 Wilddog app。如果配置失败，会抛出异常。 这个方法是线程安全的。

参数
参数名 说明
name 开发者自己起名的应用名字。这个名字只能包含字母、数字和下划线。
options 配置 Wilddog 应用所需的 WDGOptions 实例。


+ defaultApp

定义

Swift
```swift class func defaultApp() -> WDGApp?

  1. <div class="objectivec-lan">Objective-C</div>```objectivec
  2. + (nullable WDGApp *)defaultApp;
说明

返回默认的 WDGApp 实例，即通过 configureWithOptions: 配置的实例。如果默认 app 不存在，则返回 nil。 这个方法是线程安全的。

返回值

WDGApp 实例。


+ appNamed:

定义

Swift
```swift /not inherited/ init?(named name: String)

  1. <div class="objectivec-lan">Objective-C</div>```objectivec
  2. + (nullable WDGApp *)appNamed:(NSString *)name;
说明

返回一个之前通过 configureWithName:options: 配置的 WDGApp 实例。如果这个 app 不存在, 则返回 nil。 这个方法是线程安全的。

返回值

WDGApp 实例。


+ allApps

定义

Swift
```swift class func allApps() -> [AnyHashable : Any]?

  1. <div class="objectivec-lan">Objective-C</div>```objectivec
  2. + (nullable NSDictionary *)allApps;
说明

返回所有现存的 WDGApp 实例。如果没有 WDGApp 实例，则返回 nil。 这个方法是线程安全的。

返回值

包含所有 WDGApp 实例的字典，key 为 WDGApp 实例对应的名字。


- deleteApp:

定义

Swift
```swift func delete(_ completion: @escaping WDGAppVoidBoolCallback)

  1. <div class="objectivec-lan">Objective-C</div>```objectivec
  2. - (void)deleteApp:(WDGAppVoidBoolCallback)completion;
说明

清除当前的 WDGApp，释放相关的数据，并回收它的名字以便将来使用。 这个方法是线程安全的。

参数
参数名 说明
completion 删除成功后，会调用这个回调函数。