資訊專欄INFORMATION COLUMN
摘要：需要注意的是，當(dāng)你使用私有的類型時，但是這個類型也外部的一部分，這個包的使用者就得不到該類型的類型推斷，編譯器也會報警告，這時你只需要在該類型前添加即可。并且這也不影響我們發(fā)布目錄到。
文章讀譯自 The 30 second guide to publishing a typescript package to npm，部分內(nèi)容有修改哈。
這篇文章要求你有一定的 JS 、TS 和 NPM 的知識，如果你寫過普通的 NPM 包就更好啦~如果沒有的話網(wǎng)上也很多教程的，都很簡單~
發(fā)布過 npm 包的同學(xué)都知道，初始化一個 npm 項目，直接用 npm init -y 就可以了，那如果要用 ts 呢，直接 tsc --init 即可。這兩個操作會生成 package.json 和 tsconfig.json 文件。然后我們按以下步驟修改一下配置：
1. 添加 "declaration": true 到你的 tsconfig.json這行語句告訴 TypsScript 在編譯的時候為你自動生成 d.ts 文件。需要注意的是，當(dāng)你使用私有的類型時，但是這個類型也外部 API 的一部分，這個包的使用者就得不到該類型的類型推斷，TS 編譯器也會報警告，這時你只需要在該類型前添加 export 即可。
2. 添加 "types": "index.d.ts" 到你的 package.json當(dāng)其他人導(dǎo)入你的包的時候，這句話就告訴了 TS 編譯器到哪里去尋找類型定義文件。這里的 .d.ts 文件和 main 入口指向的是一個文件夾，所以通常情況下，你的 package.json 會包含下面兩行：
"main": "dist/index.js", "types": "dist/index.d.ts"
（上面默認(rèn)你在 tsconfig.json 中配置的 outDir 指向的是 dist 目錄）
3. 保證你的 dist 目錄被添加到了 .gitignore在我們的代碼倉庫，一般不需要包含編譯后的代碼，只需要包含源碼即可。所以我們不對 dist 目錄做版本管理。并且這也不影響我們發(fā)布 dist 目錄到 npm。
4. 運行構(gòu)建命令運行 tsc 即可編譯所有的源碼。這非常方便，通常情況下，我們可以添加一條命令到 package.json：
"build": "tsc"5. 運行 npm publish
接下來就是要發(fā)布到 npm 了，在 package.json 添加以下命令：
"release": "tsc && npm publish"
筆者習(xí)慣使用 standard-version 配合 commitizen 來發(fā)布 npm 包，感興趣的同學(xué)可以自行了解一下~
如果想要在發(fā)布前調(diào)試本地包，可以使用 npm link 命令，在此項目根目錄執(zhí)行npm link， 然后在要調(diào)試的 demo 項目中執(zhí)行 npm link
下面是完成配置后的 package.json：
{
"name": "my-ts-lib",
"version": "1.0.0",
"description": "My npm package written in TS",
"main": "dist/index.js",
"types": "dist/index.d.ts",
"scripts": {
"build": "tsc",
"release": "tsc && npm publish"
},
"author": "savokiss",
"license": "MIT",
"devDependencies": {
"typescript": "^3.5.3"
}
}
下面是最終的 tsconfig.json：
{
"compilerOptions": {
"target": "es5",
"module": "commonjs",
"lib": ["es2017", "es7", "es6", "dom"],
"declaration": true,
"outDir": "dist",
"strict": true,
"esModuleInterop": true
},
"exclude": ["node_modules", "dist"]
}
文章版權(quán)歸作者所有，未經(jīng)允許請勿轉(zhuǎn)載,若此文章存在違規(guī)行為，您可以聯(lián)系管理員刪除。
轉(zhuǎn)載請注明本文地址：http://systransis.cn/yun/105838.html
摘要：實際開發(fā)中，如果每個包都去走一遍這些步驟，步驟好像確實有點多。 歡迎大家前往騰訊云+社區(qū)，獲取更多騰訊海量技術(shù)實踐干貨哦~ 本文由小明plus發(fā)表 很多時候，我們可能想要用 typescript 語言來創(chuàng)建一些模塊，并提交到 npm 供別人使用， 那么在 2018 年，如果我想要初始化這樣的一個模塊，我需要做哪些步驟呢？： 答案是：創(chuàng)建一個優(yōu)雅的，對開發(fā)者友好的模塊，至少需要以下 15...
摘要：但是如果將我們的包還沒有測試好，直接發(fā)到遠(yuǎn)程未免顯得有點笨拙。發(fā)包創(chuàng)建文件在發(fā)包之前排除一些沒有必要發(fā)的文件注冊，就按照提示依次填寫信息就好了發(fā)布由于本人學(xué)識有限，有很多需要提升的地方，望大家多多指教。 創(chuàng)建一個項目目錄 mkdir project 創(chuàng)建package.json npm init 配置tsconfig.json npm -i typescript -g //全局安...
摘要：命令行工具，即。我們在寫命令行工具的時候，需要指定一個可執(zhí)行文件?；蛘咚恼{(diào)試我們?nèi)职惭b一個包后，可以全局調(diào)用這個命令行工具。 命令行工具，即 Cli(command-line interface)。是在圖形用戶界面得到普及之前使用最為廣泛的用戶界面，它通常不支持鼠標(biāo)，用戶通過鍵盤輸入指令，計算機接收到指令后，予以執(zhí)行。在學(xué)習(xí)這篇教程之前，你需要先了解NodeJs,NPM和一些常用的...
摘要：前言這個輪子已經(jīng)有很多人造過了，為了不重復(fù)造輪子，我將本項目以三階段實現(xiàn)大家可以在中的查看純前端后端前端后端前端希望能給大家一個漸進學(xué)習(xí)的經(jīng)驗。 前言 Vue+Socket.io這個輪子已經(jīng)有很多人造過了，為了不重復(fù)造輪子，我將本項目以三階段實現(xiàn)（大家可以在github中的Releases查看）： 純前端（Vuex） 后端+前端（JavaScript） 后端+前端（TypeScrip...
摘要：詳情發(fā)布新版本中可以自動修復(fù)和合并沖突的文件，還新增了命令。詳情是一個用構(gòu)建設(shè)計系統(tǒng)的開源工具，提供了一套基礎(chǔ)應(yīng)用程序開發(fā)的工具，模式和實踐。目前，只有和的最新版本支持該屬性。詳情每周一同步更新到歡迎 01. JS 引擎 V8 v6.6 的更新 最新 v6.6 版本的 V8 JavaScript 引擎更新了方法 Function.prototype.toString()，改進了代碼緩存...
閱讀 1060·2021-10-19 11:42
閱讀 3009·2021-09-10 10:51
閱讀 717·2021-09-09 09:33
閱讀 1800·2021-09-01 10:43
閱讀 2799·2019-08-30 12:43
閱讀 3545·2019-08-30 11:24
閱讀 2174·2019-08-30 10:56
閱讀 2804·2019-08-29 11:00
