Windows

Windows SDK接入

下载SDK

接入业务可以直接前往制品库下载二进制文件。

我们提供Bugly-Windows SDK和一个BuglyDemo示例工程，如果接入过程中有编译连接错误，可以参考BuglyDemo工程的配置。

接入SDK

首次使用，需要在 Bugly平台注册对应的产品组，及添加平台，以便获得对应的 AppKey 和 AppID 供后续接入使用。
参考BuglyDemo工程，设置不同构建配置下的 外部包含目录 和 库目录。
在 链接器 --> 输入 --> 附加依赖项中添加 bugly_logger.lib。
将 BuglySDK\lib\x64_release 目录中的 client_extension.dll crashpad_handler.exe crashpad_handler_extension.exe bugly_logger.dll 拷贝到业务应用exe的同目录下。
在App启动的时候初始化Bugly:

/// bugly 相关头文件
#include "bugly_agent.h"

/// appid和appkey，专业版去这里创建产品
/// https://bugly.tds.qq.com/v2/index/main
#define BUGLY_APP_ID  L"your app id"
#define BUGLY_APP_KEY L"your app key"
#define BUGLY_APP_BUNDLE_ID L"com.your.app"

/// <summary>
/// 设置bugly工作配置目录，bugly捕获到异常后生成数据会记录在这里
/// </summary>
std::wstring GenBuglyDataDirW() {
    wchar_t tmpPathBuffer[1024] = { 0 };
    ::GetTempPath(1024, tmpPathBuffer);
    std::wstring result = tmpPathBuffer;
    return result + L"BuglyDemo";
}

/// <summary>
/// 获取crashpad_handler.exe所在的路径
/// </summary>
std::wstring GenHandlerPathW() {
    std::wstring path = getExecutableDir();
    path += L"\\crashpad_handler.exe";
    return path;
}

/// <summary>
/// crash 回调函数，bugly捕获到crash后，会先回调给业务
/// 业务可以在这里添加一些日志，连同crash一起上报到bugly后台
/// </summary>
void CrashCallback(IBuglyAgent* agent, void* context) {
    if (nullptr == agent) {
        return;
    }

    std::wstring log_path = L"C:\\your_apps_log_path\\your_log_file.log";
    agent->SetLogFilePath(GetCurrentProcessId(), L"Log1", 4, log_path.c_str(), log_path.size());
}

/// <summary>
/// 初始化bugly，用于监控和上报 crash
/// </summary>
void InitBugly() {
    std::wstring handlerPath = GenHandlerPathW();
    std::wstring reportsDir = GenBuglyDataDirW();

    // 如果是监控windows系统服务进程，这个改成true，普通程序为false
    bool bIsServerProcess = false;
    std::wstring metricsDir = reportsDir;
    wchar_t pipe_name[MAX_PATH] = { 0 };
    IBuglyAgent* bugly_agent = nullptr;
    BuglyAgentResult result = CreateBuglyAgent(&bugly_agent);
    if (result != BuglyAgentResult::kSuccess) {
        return;
    }

    bugly_agent->InitBuglyManager(handlerPath.c_str(),
        reportsDir.c_str(),
        metricsDir.c_str(),
        BUGLY_APP_ID,
        BUGLY_APP_KEY,
        L"1.0.0.1",
        BUGLY_APP_BUNDLE_ID,
        L"BuglyDemo",
        L"BuglyDemoApp",
        "1.0.1234",
        5000,
        true,
        true,
        true,
        false,
        bIsServerProcess
    );

    /// 设置userid
    bugly_agent->SetKey(L"account_id", L"BuglyDemoUserId");

    const auto buglyLogDir = GenBuglyLogDirW();
    bugly_agent->LoadBuglyLoggerModule(buglyLogDir.c_str(), nullptr);

    // 中间可以通过下面的调用修改进程名
    //bugly_agent->SetKey(L"process_name", L"my_process_name.exeeeeee");

    bugly_agent->SetCrashCallback(CrashCallback, nullptr);
    // minidump收集indirectlyRefMemory
    bugly_agent->SetEnableGatherIndirectlyReferencedMemory(true);

    // 注册主exe模块的Fastfail捕获
    bugly_agent->RegisterFastfailEntrys({ _set_purecall_handler
#if _MSC_VER >= 1400  // MSVC 2005/8
                 ,
                 _set_invalid_parameter_handler
#endif  //  _MSC_VER >= 1400
        });

    // 为新LoadLibrary的dll注册Fastfail handlers
    //bugly_agent->RegisterFastfailHandlers(hMod);
}

int APIENTRY wWinMain(_In_ HINSTANCE hInstance,
                     _In_opt_ HINSTANCE hPrevInstance,
                     _In_ LPWSTR    lpCmdLine,
                     _In_ int       nCmdShow)
{
    UNREFERENCED_PARAMETER(hPrevInstance);
    UNREFERENCED_PARAMETER(lpCmdLine);

    // TODO: 在此处放置代码。

    // 初始化全局字符串
    LoadStringW(hInstance, IDS_APP_TITLE, szTitle, MAX_LOADSTRING);
    LoadStringW(hInstance, IDC_DEMO, szWindowClass, MAX_LOADSTRING);
    MyRegisterClass(hInstance);
    ....

        /// 初始化Bugly
    InitBugly();
}

在程序中构造一个crash，非调试运行触发crash后检查Bugly的诊断窗口是否弹出，再去 Bugly平台检查上报是否成功。

控制crash后是否弹窗:

 //整个禁用弹框
bugly_agent->SetKey("is_pop_dialog", "false"); 

 //白名单，指定进程才弹
bugly_agent->SetKey("is_pop_dialog", "allowlist");
bugly_agent->SetKey("add_popdlg_proc", std::to_string(::GetCurrentProcessId()).c_str()); 

更多的接口使用，请参考BuglyDemo/BuglyDemo.cpp和BuglySDK/include中的相关头文件

Windows SDK接入​

下载SDK​

接入SDK​

Windows SDK接入

下载SDK

接入SDK