无法在macOS上安装自定义R包的问题求助

问题描述 #

在Windows 10 + R 4.2.2环境开发的自定义R包myPackage，可在本地及另一台Windows 10 + R 4.1.1环境编译安装源包，但在macOS + R 4.1.1环境安装时出现警告：

Warning in install.packages:
package 'myPackage.tar.gz' is not available for this version of R

同版本R在Windows环境正常，推测为跨系统兼容问题，需要解决以实现多系统、多R版本适配。

开发环境会话信息 #

R version 4.2.2 (2022-10-31 ucrt)
Platform: x86_64-w64-mingw32/x64 (64-bit)
Running under: Windows 10 x64 (build 19044)

Matrix products: default

locale:
[1] LC_COLLATE=German_Germany.utf8  LC_CTYPE=German_Germany.utf8 
LC_MONETARY=German_Germany.utf8 LC_NUMERIC=C                   
[5] LC_TIME=German_Germany.utf8    

attached base packages:
[1] stats     graphics  grDevices utils     datasets  methods   base     

other attached packages:
[1] myPackage_0.1.0

loaded via a namespace (and not attached):
[1] Rcpp_1.0.10           pillar_1.9.0          compiler_4.2.2        iterators_1.0.14       
tools_4.2.2           
[6] digest_0.6.33         gtable_0.3.3          evaluate_0.21         lifecycle_1.0.3        
tibble_3.2.1          
[11] lattice_0.20-45       pkgconfig_2.0.3       rlang_1.1.0           foreach_1.5.2          
cli_3.6.1             
[16] rstudioapi_0.15.0     yaml_2.3.7            parallel_4.2.2         
ggVennDiagram_1.2.2   xfun_0.39             
[21] fastmap_1.1.1         dplyr_1.1.1           knitr_1.43            admisc_0.33            
generics_0.1.3        
[26] vctrs_0.6.1           locfit_1.5-9.7        grid_4.2.2            tidyselect_1.2.0       
glue_1.6.2            
[31] data.table_1.14.8     R6_2.5.1              hash_2.2.6.2          fansi_1.0.4            
RVenn_1.1.0           
[36] rmarkdown_2.23        limma_3.54.2          ggplot2_3.4.2         edgeR_3.40.2           
magrittr_2.0.3        
[41] scales_1.2.1          codetools_0.2-18      htmltools_0.5.5       testit_0.13            
colorspace_2.1-0      
[46] splitstackshape_1.4.8 utf8_1.2.3            munsell_0.5.0         doParallel_1.0.17      
venn_1.11  

包的DESCRIPTION文件内容 #

Package: myPackage
Type: Package
Title: Some Title
Version: 0.1.0
Author: Who wrote it
Maintainer: The package maintainer <yourself@somewhere.net>
Description: More about what it does (maybe more than one line)
Use four spaces when indenting paragraphs within the Description.
License: What license is it under?
Encoding: UTF-8
LazyData: true
Roxygen: list(r6 = FALSE, markdown = TRUE)
RoxygenNote: 7.2.3
Imports:
  R6,
  utils,
  data.table,
  parallel,
  doParallel,
  foreach,
  dplyr,
  ggVennDiagram,
  testit,
  ggplot2,
  venn,
  base,
  hash,
  stats,
  edgeR,
  splitstackshape,
  statmod
Suggests: 
    knitr,
    rmarkdown
VignetteBuilder: knitr

问题原因 #

1. 依赖版本不兼容：macOS上R 4.1.1无法找到符合要求的依赖包版本。比如dplyr_1.1.1、ggplot2_3.4.2等高版本依赖，可能需要R 4.2+支持，而Windows环境因本地已有高版本依赖或镜像差异，能绕过版本检查完成安装。
2. DESCRIPTION配置冗余：Imports中声明了base、stats、utils等R核心包，这类包随R默认安装，无需显式声明，可能干扰兼容性校验逻辑。
3. Roxygen版本过高：RoxygenNote:7.2.3需要R 4.2及以上版本支持，与macOS的R 4.1.1不兼容，导致包的构建信息无法被识别。
4. macOS编译环境缺失：未安装Xcode命令行工具等编译依赖，导致源包编译失败，系统误报为“包不可用”。

解决办法 #

1. 修正DESCRIPTION配置 #

• 移除核心包声明：删除Imports中的base、stats、utils、parallel，避免冗余校验。
• 降低Roxygen版本：将RoxygenNote改为兼容R 4.1.x的版本（如7.1.2），重新用roxygen2生成文档。
• 添加依赖版本限制：为依赖包指定兼容R 4.1.1的最低版本，比如dplyr (>= 1.0.0)，避免强制要求过高版本。

修改后的关键配置示例：

Imports:
  R6,
  data.table,
  doParallel,
  foreach,
  dplyr (>= 1.0.0),
  ggVennDiagram (>= 1.0.0),
  testit,
  ggplot2 (>= 3.3.0),
  venn,
  hash,
  edgeR,
  splitstackshape,
  statmod
RoxygenNote: 7.1.2

2. 适配依赖包版本 #

• 在macOS的R 4.1.1中手动安装所有依赖，确认兼容性：

  install.packages(c("R6", "data.table", "doParallel", "foreach", "dplyr", "ggVennDiagram", "testit", "ggplot2", "venn", "hash", "edgeR", "splitstackshape", "statmod"))
  

• 若某依赖安装失败，指定兼容旧版本安装：

  # 安装适配R 4.1.1的dplyr版本
  install.packages("dplyr", version = "1.0.9")
  

3. 修复macOS编译环境 #

• 安装Xcode命令行工具：打开终端执行xcode-select --install，完成后重启R。
• 用devtools安装并查看详细日志，定位具体错误：

  install.packages("devtools")
  library(devtools)
  install_local("myPackage.tar.gz", dependencies = TRUE, verbose = TRUE)
  

4. 通用兼容性优化 #

• 在DESCRIPTION中添加Depends: R (>= 4.1.0)，明确最低支持的R版本。
• 用renv或Docker搭建多版本R环境，提前测试兼容性。
• 避免使用系统专属函数，比如用file.path()替代Windows特有的\\路径写法。

内容的提问来源于stack exchange，提问作者WilliWespe