计划中的API更改 | Planned Breaking API Changes

Planned Breaking API Changes

以下列表包括将在Electron 2.0中删除的API。

没有时间表，何时会发布此版本，但至少会在90天前添加弃用警告。

app

// Deprecated
app.getAppMemoryInfo()
// Replace with
app.getAppMetrics()

BrowserWindow

// Deprecated
let optionsA = {webPreferences: {blinkFeatures: ''}}
let windowA = new BrowserWindow(optionsA)
// Replace with
let optionsB = {webPreferences: {enableBlinkFeatures: ''}}
let windowB = new BrowserWindow(optionsB)

// Deprecated
let optionsA = {titleBarStyle: 'hidden-inset'}
let windowA = new BrowserWindow(optionsA)
// Replace with
let optionsB = {titleBarStyle: 'hiddenInset'}
let windowB = new BrowserWindow(optionsB)

clipboard

// Deprecated
clipboard.readRtf()
// Replace with
clipboard.readRTF()

// Deprecated
clipboard.writeRtf()
// Replace with
clipboard.writeRTF()

// Deprecated
clipboard.readHtml()
// Replace with
clipboard.readHTML()

// Deprecated
clipboard.writeHtml()
// Replace with
clipboard.writeHTML()

crashReporter

// Deprecated
crashReporter.start{
  companyName: 'Crashly',
  submitURL: 'https://crash.server.com',
  autoSubmit: true
})
// Replace with
crashReporter.start{
  companyName: 'Crashly',
  submitURL: 'https://crash.server.com',
  uploadToServer: true
})

nativeImage

// Deprecated
nativeImage.toPng()
// Replace with
nativeImage.toPNG()

// Deprecated
nativeImage.toJpeg()
// Replace with
nativeImage.toJPEG()

// Deprecated
nativeImage.createFromBuffer(buffer, 1.0)
// Replace with
nativeImage.createFromBuffer(buffer, {
  scaleFactor: 1.0
})

process

// Deprecated
process.versions['atom-shell']
// Replace with
process.versions.electron

process.versions.electron和process.version.chrome将被设置为只读属性，以便与其他属性保持一致。process.versions由节点设置的属性。

session

// Deprecated
ses.setCertificateVerifyProc(function (hostname, certificate, callback) {
  callback(true)
})
// Replace with
ses.setCertificateVerifyProc(function (request, callback) {
  callback(0)
})

Tray

// Deprecated
tray.setHighlightMode(true)
// Replace with
tray.setHighlightMode('on')

// Deprecated
tray.setHighlightMode(false)
// Replace with
tray.setHighlightMode('off')

webContents

// Deprecated
webContents.openDevTools{detach: true})
// Replace with
webContents.openDevTools{mode: 'detach'})

// Deprecated
webContents.setZoomLevelLimits(1, 2)
// Replace with
webContents.setVisualZoomLevelLimits(1, 2)

webFrame

// Deprecated
webFrame.setZoomLevelLimits(1, 2)
// Replace with
webFrame.setVisualZoomLevelLimits(1, 2)

// Deprecated
webFrame.registerURLSchemeAsSecure('app')
// Replace with
protocol.registerStandardSchemes(['app'], {secure: true})

// Deprecated
webFrame.registerURLSchemeAsPrivileged('app', {secure: true})
// Replace with
protocol.registerStandardSchemes(['app'], {secure: true})

<webview>

// Deprecated
webview.setZoomLevelLimits(1, 2)
// Replace with
webview.setVisualZoomLevelLimits(1, 2)

节点标题URL

这是disturl在.npmrc文件中指定的URL，或者--dist-url在构建本地节点模块时作为命令行标志。

已弃用：https：//atom.io/download/atom-shell

替换为：https : //atom.io/download/electron

重复的ARM资产

每个Electron版本包含两个相同的ARM版本，文件名略有不同，例如electron-v1.7.3-linux-arm.zip和electron-v1.7.3-linux-armv7l.zip。带有v7l前缀的资产被添加以向用户阐明其支持的ARM版本，并且将其从可能生成的未来armv6l和arm64资产中消除。

没有前缀的文件仍在发布，以避免破坏可能会消耗它的任何设置。从2.0开始，未加前缀的文件将不再发布。

详情请参阅6986和7189。

FIXME 注释

该FIXME字符串在代码注释中用于表示应该为2.0版本解决的事情。请参阅https://github.com/electron/electron/search?q=fixme